GOMONTH( )-Funktion
Gibt den Tag des Monats wieder, der die angegebene Anzahl von Monaten vor oder nach einem bestimmten Datum liegt.
Syntax
GOMONTH(Datum/Datumzeit; Monate)
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
| Datum/Datumzeit |
Datumzeit |
Das Feld, der Ausdruck oder Literalwert, ab dem das Ausgabedatum berechnet werden soll. |
| Monate |
numerisch |
Die Anzahl der Monate vor oder nach Datum/Datumzeit. Hinweis Sie können für Datum/Datumzeit einen Datumzeit-Wert angeben, jedoch wird der Zeitteil des Werts ignoriert. |
Ausgabe
Datumzeit. Der Datumswert wird im aktuellen Analytics-Datumsformat angezeigt.
Beispiele
Einfache Beispiele
Literale Eingabewerte
Plus drei Monate
Gibt `20140415` zurück, was als „15 Apr 2014“ angezeigt wird, unter der Annahme eines aktuellen Analytics-Datumanzeigeformats von „TT MMM JJJJ“:
GOMONTH(`20140115`; 3)
Minus drei Monate
Gibt `20131015` zurück, was als „15 Okt 2013“ angezeigt wird, unter der Annahme eines aktuellen Analytics-Datumanzeigeformats von „TT MMM JJJJ“:
GOMONTH(`20140115`; -3)
Feldeingabewerte
Plus drei Monate
Gibt das Datum, das drei Monate nach jedem Datum im Feld Rechnungsdatum liegt, zurück:
GOMONTH(Rechnungsdatum; 3)
Plus drei Monate und 15 Tage
Gibt das Datum, das drei Monate nach jedem Datum im Feld Rechnungsdatum liegt, plus einer Nachfrist von 15 Tagen zurück:
GOMONTH(Rechnungsdatum + 15; 3)
Weiterführende Beispiele
Datumsrundung zur Verhinderung nicht bestehender Datumswerte
Falls die Kombination aus Datum/Datumzeit und Monate ein nicht existierendes Datum ergibt, verwendet die Funktion GOMONTH( ) eine „Datumsrundung“, um das nächstgelegene gültige Datum zurückzugeben.
Keine Datumsrundung erforderlich
Das Hinzurechnen eines Monats zum 30. März 2014 ergibt `20140430`, angezeigt als 30. April 2014 unter der Annahme eines aktuellen Analytics-Datumsanzeigeformats von TT MMM JJJJ:
GOMONTH(`20140330`; 1)
Datumsrundung angewendet
Das Hinzurechnen eines Monats zum 31. März 2014 ergibt ebenfalls `20140430`, angezeigt als 30. April 2014 unter der Annahme eines aktuellen Analytics-Datumsanzeigeformats von TT MMM JJJJ: Die Datumsrundung verhindert, dass das zweite Beispiel den 31. April 2014 liefert, der ein ungültiges Datum darstellen würde.
GOMONTH(`20140331`; 1)
Bemerkungen
Die korrekte Verwendung von Datums- und Zeitfunktionen kann manchmal schwierig sein. In der Hilfe beschreiben die Funktionsthemen die spezifischen Einzelheiten der einzelnen Funktionen. Informationen über allgemeine Überlegungen bei der Verwendung von Datum- und Zeitfunktion finden Sie in den folgenden Themen:
- Verwenden von Datumzeiten in Ausdrücken
- Serielle Datumzeiten
- Wie sich UTC-Offsets auf Datumzeit-Ausdrücke auswirken
- Datums- und Uhrzeitoptionen
Datumzeit-Formate
Ein für Datum/Datumzeit spezifiziertes Feld kann ein beliebiges Datums- oder Datumzeit-Format verwenden, vorausgesetzt die Felddefinition definiert das Format korrekt.
Ein literaler Datumswert muss einem der folgenden Formate entsprechen:
- JJJJMMTT
- JJMMTT
Ein literales Datum muss in Backquotes angegeben werden. Zum Beispiel: `20141231`
Wie der Wert Monate funktioniert
- Positiver Wert Das Ausgabedatum liegt nach der Angabe von Datum/Datumzeit.
- Negativer Wert Das Ausgabedatum liegt vor der Angabe von Datum/Datumzeit.
- Wert ausgelassen oder '0' (Null) Das Ausgabedatum ist mit der Angabe von Datum/Datumzeit identisch.
Verwandte Funktionen
Verwenden Sie die EOMONTH( )-Funktion, wenn Sie ein genaues Datum statt des Monatsultimos angegeben haben möchten, das eine bestimmte Anzahl an Monaten vor oder nach dem spezifizierten Datum liegt.
