|
| |||||||||||||||||||||||||
|
| |||||||||||||||||||||||||
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.
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(Datum).AusKultur(de)].
Als Bezugsdatum für [cX.DatumZeit(Bezugsdatum).X] in kann auch "heute" bzw. "today" angegeben werden. Wird es ausgelassen, wird der aktuelle Zeitpunkt verwendet.
Beginnt die Angabe mit 'S', wird dies als Zeitspanne seit Mitternacht interpretiert (Standard: Sekunden). Beispiel: [cX.DatumZeit(S60).Zeit] ergibt 00:01, also eine Minute aus den 60 Sekunden (siehe etwa auch [cX.System.Stoppuhr]).
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)]. Es wird Datum2-Datum1 berechnet. 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, T=Zeitangabe 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. Hinweis: Durch Prüfen auf kleiner oder größer 0 kann hiermit auch geprüft werden, ob das 2. Datum vor oder nach dem ersten liegt. |
| .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) |
| .InGrenzen(Min;Max) | Liefert Wahr, wenn das Stichdatum bei [cX.DatumZeit().InGrenzen(Min;Max)] zwischen Min und Max liegt. Optional können noch Ergebniswerte für 'vor Min', 'nach Max' und 'im Zeitraum' angegeben werden. |
| .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 (z.B. 22.04.2024) |
| .Lang | Lange Darstellung des gegebenen Datums (z.B. Montag, 22. April 2024) |
| .Monatsletzter | Tageszahl am Monatsende des angegebenen Datums (28-31) |
| .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 |
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
