Diese Funktion unterstützt nur Kompatibilitätsmodus-Daten.
Wir empfehlen Ihnen, ältere Datumsfelder in Ihren Datenquellen auf die neuen Typen "Datum" und "Datum und Uhrzeit" umzustellen. Nach dem Upgrade:
- Mit der Funktion FORMAT_DATETIME können Sie ein Datum als Text formatieren.
- Mit den Funktionen PARSE_DATE und PARSE_DATETIME können Sie Text in Felder vom Typ „Datum“ sowie „Datum und Uhrzeit“ konvertieren.
Sie können TODATE auf zweierlei Weise nutzen:
- Aus Textfeldern ein Kompatibilitätsmodus-Datum erstellen
- Anzeigeformat und Detaillierungsgrad eines Kompatibilitätsmodus-Datums ändern
Verwendungsbeispiel
TODATE(text date,"%Y/%m/%d","%Y-%m-%d")
TODATE(response_time, 'NANOS', '%Y%m%d')
TODATE(create_time, 'DECIMAL_DATE', '%Y')
Syntax
TODATE(field_expression, input_date_format, output_date_format)
Eingabeformate
input_date_format
ist optional, wenn field_expression
richtig als semantisches Datum konfiguriert ist.
Die Funktion TODATE unterstützt Strings in den folgenden Formaten für die Eingabe:
- "BASIC" – Unterstütztes Format: YYYY/MM/DD-HH:MM:SS
- "DEFAULT_DASH" – Unterstütztes Format: YYYY-MM-DD [HH:MM:SS[.uuuuuu]]
- "DEFAULT_SLASH" – Unterstütztes Format: YYYY/MM/DD [HH:MM:SS[.uuuuuu]]
- "DEFAULT_DECIMAL" – Unterstütztes Format: YYYYMMDD [HH:MM:SS[.uuuuuu]]
- "RFC_1123" – Beispielformat: Sat, 24 May 2008 20:09:47 GMT
- "RFC_3339" – Beispielformat: 2008-05-24T20:09:47Z
- "SECONDS" – Sekunden seit Epoch
- "MILLIS" – Millisekunden seit Epoch
- "MICROS" – Mikrosekunden seit Epoch
- "NANOS" – Nanosekunden seit Epoch
- "JULIAN_DATE" – Tage seit Epoch
- "DECIMAL_DATE" – Identisch mit "DEFAULT_DECIMAL"
- Jedes gültige strptime-Format als String
Ausgabeformate
Die Funktion TODATE unterstützt Strings in den folgenden Formaten für die Ausgabe:
- "%Y" – Jahr
- "%m" – Monat
- "%d" – Tag
- "%W" – Kalenderwoche
- "%w" – Wochentag
- "%H" – Stunde
- "%M" – Minute
Beispiele
- JJJJMMTT (kanonisches Datum in Looker Studio):
"%Y%m%d"
- Datum Stunde:
"%Y%m%d%H"
- Jahr Woche:
"%Y%W"
- Jahr Monat:
"%Y%m"
Hinweise
TODATE gibt die Datentypen für das Kompatibilitätsmodus-Datum zurück.