42 Software Online-Hilfe Portal

Datum

Diese Datei dokumentiert alle Makrofunktionen der Kategorie Datum.

Inhaltsverzeichnis

CalcDate(Date,Days)

Ermittelt ein neues Datum in dem zum Startdatum eine Anzahl von Tagen addiert wird

Parameter

Nr. Parameter Beschreibung
1 Date Datum
2 Days Tage

Rückgabewert

Datum

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = CalcDate(SysDate (), +14);
    print("Ergebnis = "+erg);
    erg1 = CalcDate(SysDate(), -14);
    print("Ergebnis = "+erg1);
}

CalcDateTime(Datetime,Duration)

Addiert eine Dauer auf ein Zeitpunktfeld

Parameter

Nr. Parameter Beschreibung
1 Datetime Zeitpunkt
2 Duration Dauer

Rückgabewert

Zeitpunkt

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Vor = SysDateTime ();
    print("Vor CalcDateTime = "+Vor);
    // Format TT:HH:MM
    Nach = CalcDateTime(SysDateTime(), "01:01:00");
    print("Nach CalcDateTime = "+Nach);
}

CalcDateTimeMin(Datetime,Minuten)

Addiert Minuten auf ein Zeitpunktfeld

Parameter

Nr. Parameter Beschreibung
1 Datetime Zeitpunkt
2 Minuten Minuten

Rückgabewert

Zeitpunkt

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Vor1 = SysDateTime ();
    print("Vor CalcDateTimeMin = "+Vor1);
    Nach1 = CalcDateTimeMin(SysDateTime(), "10");
    print("Nach CalcDateTimeMin = "+Nach1);
}

CalcDays(Date1,Date2)

Ermittelt die Anzahl der Tage zwischen zwei Datumsangaben

Parameter

Nr. Parameter Beschreibung
1 Date1 Datum1
2 Date2 Datum2

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in den Dateien 42Library.42m und 42LibTest.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    erg = CalcDays(SysDate (), CalcDate (SysDate (), +14));
    print("Ergebnis = "+erg);
}

CalcYears(Date1,Date2)

Ermittelt die Anzahl der Jahre zwischen zwei Datumsangaben

Parameter

Nr. Parameter Beschreibung
1 Date1 Datum1
2 Date2 Datum2

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = CalcYears(SysDate (), CalcDate (SysDate (), +1400));
    print("Startdatum = "+SysDate());
    print("Endedatum = "+CalcDate(SysDate(), +1400));
    print("Ergebnis = "+erg);
}

DateCmp(Date1,Date2)

Vergleicht zwei Daten miteinander

Parameter

Nr. Parameter Beschreibung
1 Date1 Datum1
2 Date2 Datum2

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = DateCmp(SysDate (), CalcDate (SysDate(), +14));
    print("Ergebnis = "+erg);
    // ergibt 14
}

DateTimeCmp(Date1,Date2)

Vergleicht zwei Zeitpunktfelder miteinander

Parameter

Nr. Parameter Beschreibung
1 Date1 Datum 1
2 Date2 Datum 2

Rückgabewert

0:Identisch, 1:Zeitpunkt2 > Zeitpunkt1, -1:Zeitpunkt2 < Zeitpunkt1

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = DateTimeCmp(SysDateTime (), CalcDateTime (SysDateTime(), 14));
    print("Ergebnis = "+erg);
    erg = DateTimeCmp(SysDateTime(), CalcDateTime(SysDateTime(), -14));
    print("Ergebnis = "+erg);
    erg = DateTimeCmp(SysDateTime(), SysDateTime());
    print("Ergebnis = "+erg);
}

DateTimeToOleDate()

Konvertiert ein Zeitpunktfeld in ein OLE DATE

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Ole DATE

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Erg = DateTimeToOleDate(SysDateTime ());
    print("DateTimeToOleDate = "+Erg);
}

Day(Date)

Ermittelt den Tag des Datums

Parameter

Nr. Parameter Beschreibung
1 Date Datum

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    Erg = Day("10.07.2011");
    print("Tag = "+Erg);
    Erg1 = Day(SysDate());
    print("aktueller Tag = "+Erg1);
}

DayOfWeek(Date,[Fmt])

Ermittelt den Wochentag des Datums

Parameter

Nr. Parameter Beschreibung
1 Date Datum
2 Fmt Optional: Ausgabeformat: 0=Zahl (0), 1=Kürzel (Mon), 2=Name (Montag)

Rückgabewert

Text

Verfügbarkeit

Standard

Beispiel

Main()
{
    x = DayOfWeek(SysDate(), 0);
    print("Ergebnis = "+x);
    k = DayOfWeek(SysDate(), 1);
    print("Ergebnis = "+k);
    t = DayOfWeek(SysDate(), 2);
    print("Ergebnis = "+t);
}

DurationToMin(Duration)

Konvertiert ein Dauerfeld in Minuten

Parameter

Nr. Parameter Beschreibung
1 Duration Dauer

Rückgabewert

Minuten

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    // Format TT:HH:MM
    Erg = DurationToMin("01:01:10");
    print("DurationToMin = "+Erg);
}

FormatDate(Date,[Fmt])

Formatiert das Datum nach freier Definition

Parameter

Nr. Parameter Beschreibung
1 Date Datum
2 Fmt Optional: Ausgabeformat

Rückgabewert

Text

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = FormatDate(SysDate (), "TT.MM.JJ");
    print("Ergebnis = "+erg);
    erg = FormatDate(SysDate(), "TT.MM.JJJJ");
    print("Ergebnis = "+erg);
    erg = FormatDate(SysDate(), "T.MMMM.JJJJ");
    print("Ergebnis = "+erg);
}

FormatDateTime(Date,[Fmt])

Formatiert das Zeitpunktfeld nach freier Definition

Parameter

Nr. Parameter Beschreibung
1 Date Zeitpunkt
2 Fmt Optional: Ausgabeformat

Rückgabewert

Text

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    erg = FormatDateTime(SysDateTime (), "MM.TT.JJ HH");
    print("Ergebnis = "+erg);
    erg = FormatDateTime(SysDateTime(), "MM.TT.JJ HH:MM");
    print("Ergebnis = "+erg);
    erg = FormatDateTime(SysDateTime(), "MM.TT.JJ HH:MM:SS");
    print("Ergebnis = "+erg);
}

GetQuarter(Date)

Ermittelt das zugehörige Quartal für das Datum

Parameter

Nr. Parameter Beschreibung
1 Date Datum

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = GetQuarter(SysDate ());
    print("Ergebnis = "+erg);
}

GetWeek(Date)

Ermittelt die zugehörige Kalenderwoche des Datums

Parameter

Nr. Parameter Beschreibung
1 Date Datum

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = GetWeek(SysDate ());
    print("Ergebnis = "+erg);
}

MinToDuration(Minuten)

Konvertiert Minuten in ein Dauerfeld

Parameter

Nr. Parameter Beschreibung
1 Minuten Minuten

Rückgabewert

Dauer

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Erg1 = MinToDuration("1510");
    print("MinToDuration = "+Erg1);
}

Month(Date)

Ermittelt den zugehörigen Monat des Datums

Parameter

Nr. Parameter Beschreibung
1 Date Datum

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = Month(Sysdate ());
    print("Ergebnis = "+erg);
}

OleDateToDateTime()

Konvertiert ein OLE DATE in ein Zeitpunktfeld

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Zeitpunkt

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Erg = OleDateToDateTime("04.14.2002");
    print("OleDateToDateTime = "+Erg);
}

SysDate()

Ermittelt das aktuelle Systemdatum

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Datum

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = SysDate();
    print("Ergebnis = "+erg);
}

SysDateTime()

Ermittelt das aktuelle Systemdatum und -zeit

Parameter

Diese Funktion hat keine oder keine benannten Parameter.

Rückgabewert

Zeitpunkt

Verfügbarkeit

Standard

Beispiel

Ein Beispiel finden Sie in der Datei 42Time.42m im Verzeichnis Makro / Beispiele / Programmierhandbuch Beispiele
Main()
{
    Erg5 = SysDateTime();
    print("SysDateTime = "+Erg5);
}

Year(Date)

Ermittelt das zugehörige Jahr für das Datum

Parameter

Nr. Parameter Beschreibung
1 Date Datum

Rückgabewert

Zahl

Verfügbarkeit

Standard

Beispiel

Main()
{
    erg = Year(SysDate ());
    print("Ergebnis = "+erg);
}