Datumsformeln
formatDate
Die Formel formatDate(date, format) dient dem strukturierten Ausgeben von Datumswerten. Dabei wird ein Datum und das gewünschte Format angegeben. Das gewünschte Format wird über einen Text für format angegeben.
Dabei sollte beachtet werden, dass Texte innerhalb des Formates per Delimiter(') angegeben werden müssen. So ist bspw. das Format "Der dd. MMMM ist ein Feiertag" nicht zulässig, da der enthaltene Text “Der […] ist ein Feiertag” mit als Format interpretiert wird. Um speziell Text mit einem Datum zu verbinden, sollte ein Delimiter genutzt werden: "'Der 'dd. MMMM' ist ein Feiertag'"
Formatierungsmöglichkeiten bei formatDate
Das Format kann beliebig aus den folgenden Symbolen zusammengesetzt werden:
| Symbol | Beschreibung | Ausgabe in | Beispiel |
|---|---|---|---|
| G | Bezeichnung | (Text) | AD |
| yyyy | Jahr | (Zahl) | 2022 |
| M | Monat im Jahr (kurz) | (Zahl) | 1 |
| MM | Monat im Jahr (lang) | (Zahl) | 01 |
| MMM | Monatsname (kurz) | (Text) | Jan |
| MMMM | Monatsname (lang) | (Text) | Januar |
| L | alleinstehender Monat | (Text & Zahl) | Januar & 01 |
| d | Tag im Monat | (Zahl) | 5 |
| dd | Tag im Monat (lang) | (Zahl) | 05 |
| c | alleinstehender Tag | (Zahl) | 10 |
| h | Stunde am/pm (1~12) | (Zahl) | 12 |
| H | Stunde in Tag (0~23) | (Zahl) | 0 |
| m | Minuten einer Stunde | (Zahl) | 30 |
| s | Sekunden einer Minute | (Zahl) | 55 |
| S | fractional second | (Zahl) | 978 |
| EEE | Wochentag (kurz) | (Text) | Do. |
| EEEE | Wochentag (lang) | (Text) | Donnerstag |
| D | Tag im Jahr | (Number) | 189 |
| a | am/pm marker | (Text) | PM |
| k | hour in day (1~24) | (Number) | 24 |
| K | hour in am/pm (0~11) | (Number) | 0 |
| Q | Quartal | (Zahl) | 3 |
| QQQ | Quartal (kurz) | (Text & Zahl) | Q3 |
| QQQQ | Quartal (lang) | (Text & Zahl) | 3. Quartal |
| ’ | Angabe von Text innerhalb des Formates | (Delimiter) | ‘Date=’ |
| ’’ | Angabe von Text innerhalb des Formates mit hochkomma | (Literal) | '’o’clock’’ |
Hinweis: Das Symbol “E” sollte nicht mehr verwendet werden, da es zu unerwarteten Ergebnissen führen kann; stattdessen können “EEE” oder “EEEE” genutzt werden.
Formatierungsbeispiele
| Formatierung | Ausgabe |
|---|---|
formatDate(today(), "dd.MM.yyyy") | “15.06.2021” |
formatDate(today(), "dd.MM.yyyy HH:mm:ss") | “15.06.2021 08:00:00” |
formatDate(today(), "dd.MM.yyyy HH:mm:ss.SSS") | “15.06.2021 08:00:00.000” |
formatDate(today(),"dd. MMMM, yyyy") | “15. Juni, 2021” |
formatDate(today(),"QQQQ, yyyy") | “2. Quartal, 2021” |
formatDate(today(),"'Der 'dd. MMMM' ist ein Feiertag'") | “Der 15. Juni ist ein Feiertag” |
Datumskonstanten
| Konstante | Beispiel | Beschreibung | Rückgabe |
|---|---|---|---|
defaultDateTime |
| Gibt das Datum 00:00 01.01.1970. Dieses Datum wird nicht angezeigt | Datum |
currentWeek |
| Aktuelle Kalenderwoche | Text |
currentMonth |
| Liefert den aktuellen Monat in Form eines Textes | Text |
currentYear |
| Keine Beschreibung vorhanden | Zahl |
Formelübersicht
| Formel | Parameter | Beispiel | Beschreibung | Rückgabe |
|---|---|---|---|---|
formatDate(date, format) | 1. Wert: Datum, 2. Wert: Text |
| Die Formel formatDate(date, format) dient dem strukturierten Ausgeben von Datumswerten. Dabei wird ein Datum und das gewünschte Format angegeben. Das gewünschte Format wird über einen Text für format angegeben. Mögliche Formatierungen gibt es in den Univelop Docs | Text |
date(year, month, day) | 1. Wert: Zahl, 2. Wert: Zahl, 3. Wert: Zahl |
| Erstellt ein Datum aus gegebenem Jahr, Monat und Tag | Datum |
parseDate(text) | 1. Wert: Text |
| Erstellt Datum aus Text im Format “dd.mm.yy” oder “dd.mm.yyyy”, nur dieses Format ist zulässig | Datum |
tryParseDate(value) | 1. Wert: Dynamischer Wert |
| Versucht ein Datum aus value zu machen. Tritt ein Fehler auf wird defaultDateTime zurück gegeben | Datum |
today() | Keine Parameter |
| Datum, bestehend aus dem aktuellen Tag um 00:00 Uhr | Datum |
now() | Keine Parameter |
| Datum, bestehend aus dem aktuellen Zeitpunkt | Datum |
calendarWeek(date) | 1. Wert: Datum |
| Kalenderwoche des gegebenen Datums | Zahl |
startOfWeek([date]) | 1. Wert: Datum (Optional) |
| Start der aktuellen Kalenderwoche | Datum |
endOfWeek([date]) | 1. Wert: Datum (Optional) |
| Ende der aktuellen Kalenderwoche | Datum |
dateToWeek(date) | 1. Wert: Datum |
| Kalenderwoche des Datums | Text |
addWeeks(date/week, weeks) | 1. Wert: Dynamischer Wert, 2. Wert: Zahl |
| Wochen auf ein Datum oder einen Wochentext addieren | Dynamischer Wert |
subtractWeeks(date/week, weeks) | 1. Wert: Dynamischer Wert, 2. Wert: Zahl |
| Subtrahiere Wochen von einem Datum oder Wochentext | Dynamischer Wert |
startOfMonth([date]) | 1. Wert: Datum (Optional) |
| Beginn des aktuellen Monats | Datum |
endOfMonth([date]) | 1. Wert: Datum (Optional) |
| Ende des aktuellen Monats | Datum |
dateToMonth(date) | 1. Wert: Datum |
| Jahr und Monat im Format YYYY-MM | Text |
addMonths(date/month, months) | 1. Wert: Dynamischer Wert, 2. Wert: Zahl |
| Monate auf ein Datum oder Monatstext addieren | Dynamischer Wert |
subtractMonths(date/month, months) | 1. Wert: Dynamischer Wert, 2. Wert: Zahl |
| Monate von einem Datum oder Monatstext subtrahieren | Dynamischer Wert |
addYears(date, years) | 1. Wert: Datum, 2. Wert: Zahl |
| Keine Beschreibung vorhanden | Datum |
subtractYears(date, years) | 1. Wert: Datum, 2. Wert: Zahl |
| Keine Beschreibung vorhanden | Datum |
startOfQuarter([date]) | 1. Wert: Datum (Optional) |
| Beginn des aktuellen Quartals | Datum |
endOfQuarter([date]) | 1. Wert: Datum (Optional) |
| Ende des aktuellen Quartals | Datum |
startOfYear([date]) | 1. Wert: Datum (Optional) |
| Beginn des aktuellen Jahres | Datum |
endOfYear([date]) | 1. Wert: Datum (Optional) |
| Ende des aktuellen Jahres | Datum |
addMinutes(date, minutes) | 1. Wert: Datum, 2. Wert: Zahl |
| Minuten auf einen Zeitpunkt addieren | Datum |
subtractMinutes(date, minutes) | 1. Wert: Datum, 2. Wert: Zahl |
| Minuten von einem Zeitpunkt subtrahieren | Datum |
addHours(date, hours) | 1. Wert: Datum, 2. Wert: Zahl |
| Addiert Stunden auf den gegebenen Zeitpunkt. | Datum |
subtractHours(date, hours) | 1. Wert: Datum, 2. Wert: Zahl |
| Subtrahiert Stunden von dem gegebenen Zeitpunkt. | Datum |
addDays(date, days) | 1. Wert: Datum, 2. Wert: Zahl |
| Addiert Tage auf den gegebenen Zeitpunkt. | Datum |
subtractDays(date, days) | 1. Wert: Datum, 2. Wert: Zahl |
| Subtrahiert Tage von dem gegebenen Zeitpunkt. | Datum |
datesBetween(startDate, endDate, [options]) | 1. Wert: Datum, 2. Wert: Datum, 3. Wert: Text (Optional) |
| Daten zwischen den zwei gegebenen Daten. Unter [option] kann optional über den Text “weekdays” angegeben werden, dass nur Werktage angegeben werden sollen. | Liste |
daysBetween(startDate, endDate) | 1. Wert: Datum, 2. Wert: Datum |
| Anzahl der Tage zwischen dem startDate und dem endDate | Zahl |
hoursBetween(startDate, endDate) | 1. Wert: Datum, 2. Wert: Datum |
| Anzahl der Stunden zwischen dem startDate und dem endDate | Zahl |
combineDateAndTime(date, time) | 1. Wert: Datum, 2. Wert: Text |
| combineDateAndTime(today(), “12:00”) liefert das Datum von heute mit der Uhrzeit 12:00 | Datum |