|
| |||||||||||||||||||||||||
|
| |||||||||||||||||||||||||
FG Für die Verarbeitung von Datums- und Zeitangaben sowie Zeiträumen steht der Platzhalterbereich [cX.DatumZeit().X] zur Verfügung.
Ohne eine Angabe für X liefert der Ausdruck die angegebene (bzw. aktuelle) Datums/Zeit-Angabe.
Für X kann stehen:
| .Addieren(Zeitspanne) | Datums/Zeitwerte addieren bei Angabe von [cX.DatumZeit(Datum1).Addieren(Zeitspanne)]. Zeitwerte bzw. Zeitspannen werden als Paare wie "ms;2" oder "d;1" definiert - siehe Zeitspanne Ist ein Datum und/oder eine Uhrzeit angegeben, wird diese addiert. Eine Variante ist".Addieren(X;n)", wobei n Einheiten X addiert werden mit X= D (Tage), W (Wochen), M (Monate), FM (Volle Monate, wobei ein Monatsletzter wird auch zu Monatsletztem wird), Y (Jahre), H (Stunden), N oder MI (Minuten), S (Sekunden), MS (Millisekunden). Es können auch mehrere solche Paare hintereinander angegeben werden. [cX.DatumZeit.Addieren(D;2)] liefert also das Datum von übermorgen. Soll ein einfacher Zeitwert addiert werden, kann dies auch per Postfix angegeben werden, etwa 1ms, 1s, 1n oder 1mi, 1h, 1d (ähnlich wie bei Größenangaben) |
| .AusFormat(Format) | EX Liefert das Datum, welches in einem eigenen Format vorliegt, wobei die Formatdefinition als Index angegeben wird |
| .AusKultur(Kultur) | EX Wertet das angegebene Datum je nach der als Index angegebenen Kultur (z.B. DE oder EN) aus und liefert das Datum in der aktuellen Darstellung zurück |
| .AusWert(Wert) | Angegebenen Zahlenwert in Datum/Zeitwert umrechnen - siehe auch .Wert() |
| .AusWert4(Wert) | Angegebenen Zahlenwert in Datum umrechnen (Tageszähler seit 1.1.1900 wie in cX4, siehe auch Dat4("X")-Funktion) |
| .DauerInSekunden(Wert) | Umrechnen der gegebenen Zeitspanne in Sekunden |
| .Differenz(Datum2) | Differenz zweier Datums/Zeitwerte ermitteln bei Angabe von [cX.DatumZeit(Datum1).Differenz(Datum2)]. Ist kein Datum2 angegeben, wird der aktuelle Zeitpunkt verwendet. Als zweiter Parameter kann die Einheit angegeben werden, in der das Ergebnis ermittelt werden soll: Y=Jahre, M=Monate, W=Wochen, D=Tage, H=Stunden, N=Minuten, S=Sekunden, MS=Millisekunden Wird die Einheit mit % ergänzt, wird der ganzzahlige gerundete Wert geliefert. [cX.DatumZeit(1.5.2021).Differenz(1.6.21;W)] liefert daher 4,428... Wochen, [cX.DatumZeit(1.5.2021).Differenz(1.6.21;W%)] liefert 4. |
| .Format(Format) | Liefert das Datum mit der angegebenem Formatierungsanweisung (z.B. "U") Datums-/Zeitformate d: kurzes Datum D: langes Datum f: vollständiges Datum/kurze Zeit F: Full Date/Long Time g: allgemeines Datum/kurze Zeit G: allgemeines Datum/lange Zeit M, m: Monat/Tag O, o: Roundtrip-Datum/-Uhrzeit R, r: RFC1123 s: Sortierbares Datum/Uhrzeit t: Kurzzeit T: lange Zeit u: universelle sortierbare Datums-/uhrzeitanzeit U: universelles vollständiges Datum/Uhrzeit Y, y: Year Month ddd: abgekürzter Name des Wochentags g, gg: ERA-Name MMM: abgekürzter Monatsname MMMM: vollständiger Monatsname t: das erste Zeichen des am/pm-Kennzeichens TT: vollständiges am/pm-Kennzeichen :: Zeit-Trennzeichen /: Datums-Trennzeichen |
|
| .Gültig | Liefert 1, wenn eine gültige Datums-/Zeitangabe vorliegt |
| .InKultur(Kultur) | EX Liefert das gegebene Datum in der Schreibweise der angegebenen Kultur (z.B. en). |
| .Internet | FG Datum in die (sortierbare) internationale Internet-Darstellung umwandeln, z.B. "2022-06-20 18:30:52Z" (Rückumwandlung siehe .AusFormat) |
| .IstImZeitraum(Modus) | Liefert 1, wenn das Datum in einem bestimmten Zeitraum liegt. Hierzu können als Index 2 Datumsangaben eingetragen werden oder nur ein Moduswert: 1=heute, 2=diese Woche, 3=Monat, 4=Quartal, 5=Jahr 11=morgen, 12=nächste Woche, 13=Monat,14=Quartal, 15=Jahr -11=heute, -12=vorherige Woche, -13=Monat,-14=Quartal, -15=Jahr Wird 20 addiert, wird auf übernächstes geprüft usw. |
| .Kurz | Kurze Darstellung des gegebenen Datums |
| .Lang | Lange Darstellung des gegebenen Datums |
| .Monatsletzter | Tageszahl am Monatsende des angegebenen Datums |
| .Ostern(Jahr) | Liefert das Datum von Ostersonntag im angegebenen Jahr. |
| .Sekunden | Liefert die Sekunden (seit Mitternacht) der angegebenen Zeit |
| .SekundenInZeit(Wert) | Umrechnen der gegebenen Anzahl Sekunden in eine Zeitangabe (h:mm:ss) |
| .SQL | FG SQL-Darstellung des gegebenen Datums im Format yyyy-MM-dd HH:mm:ss (Rückumwandlung siehe .AusFormat) |
| .Subtrahieren(Datum2) | Datums/Zeitwerte subtrahieren bei Angabe von [cX.DatumZeit(Datum1).Subtrahieren(Zeitspanne)]. Weitere Optionen siehe oben ".Addieren()" |
| .TagDesJahres | Liefert die Tageszahl im Jahr (1.1. = 1) |
| .Text(Modus) | Liefert eine lange Darstellung des gegebenen Datums mit ggf. "Heute"/"Gestern"/"Morgen". Optional kann als Index ein Modus angegeben werden: 1=Nur Datum (ohne Zeit), 2=Nur Zeit (ohne Datum), 3=Langes Datums-/Zeitformat, 4=Zeit mit Millisekunden, 5=Sortierbares Format |
| .Ticks | Liefert die Ticks des angegebenen Datums |
| .UNIX | FG UNIX-Darstellung (Sekundenanzahl) des gegebenen Datums |
| .UTC | FG Liefert die Universalzeit zur angegebenen lokalen Zeit |
| .VonUNIX | FG Datum aus UNIX-Darstellung (Sekundenanzahl) ermitteln |
| .VonUTC | FG Liefert die lokale zur angegebenen Universalzeit |
| .Wert | Zahlenwert des gegebenen Datums (Nachkommastellen=Zeitwert) - siehe auch .AusWert() |
| .WochenNummer | Liefert die Wochennummer des Datums |
| .Wochentag | Liefert die Nummer des Tages in der Woche (je nach Systemeinstellung ist dann etwa Montag=1 und Sonntag=7) |
| .WochentagsName(Index) | Liefert den Namen des per Index (1..7) angegebenen Wochentags. Index=1 liefert den im System eingestellten Tag des Wochenbeginns (Deutschland: Montag). Index=0 (oder kein Index) liefert den Tagesnamen des angegebenen bzw. heutigen Datums. Hinweis: Um einen Monatsnamen zu ermitteln, kann dies per Formatierung erfolgen, etwa [cX.DatumZeit(1.[Index].2020)§MMMM]. |
| .Zeit | Liefert die Uhrzeit des angegebenen Zeitpunkts |
| .Zeitangabe | Angabe des angegebenen Zeitraums als Uhrzeit h:mm:ss |
Die Angabe eines Datums muss in einer Form erfolgen, die in der aktuellen bzw. eingestellten Sprache bzw. Kultur gültig ist. Sollte ein mehrsprachiges Skript fest eingetragene Datumswerte enthalten, empfiehlt sich die Verwendung von [cX.Datum(X).AusKultur(de)]. Als Datum kann auch "heute" angegeben werden.
Hinweis: Um eine Einzelangabe eines Datums/Zeitpunkts zu ermitteln, etwa die Minute, kann eine Formatierung verwendet werden. Um etwa die Minutenzahl der aktuellen Zeit zu erhalten, reicht [cX.DatumZeit§mm]
cX-Webseite: http://www.clickexe.net
