Datum & Zeit
Um ein bestimmtes Datum festzulegen, können Sie die Designer der DateTime-Struktur oder der ToDateTime-Funktion (weitere Details im Abschnitt "Umrechnung") oder DateSerial (siehe unten) verwenden.
Um beispielsweise ein Datum und eine Uhrzeit mit dem Designer zu erstellen, können Sie den folgenden Code verwenden:
new DateTime(Jahr, Monat, Tag, Stunden, Minuten, Sekunden);
Wenn Sie die Funktionen zur Datumskonvertierung aus diesem Abschnitt verwenden, wird standardmäßig auch die Zeitinformation gespeichert. Sie können die Funktionen Format oder FormatDateTime verwenden, um die Uhrzeit aus dem Datum zu entfernen. Weitere Informationen zu diesen Funktionen finden Sie im Abschnitt "Formatierung".
Das Feld [Employees.BirthDate] aus der Demo-Datenbank wird als Beispiel für die Verwendung eines Feldes aus der Datenbank in den Funktionen verwendet.
[Employees.BirthDate] = 27.01.1986
AddDays
| Funktion | Parameter | Rückgabewert |
|---|---|---|
AddDays |
DateTime date, double value |
DateTime |
Fügt dem Datum date die bestimmte Anzahl an Tagen (value) und gibt ein neues Datum zurück.
Beispiel:
AddDays(new DateTime(2024,4,2), 2) = 04.04.2024 00:00:00
AddDays(ToDateTime("2.4.2024"), 2) = 04.04.2024 00:00:00
AddDays([Employees.BirthDate], 2) = 29.01.1986 00:00:00
AddHours
| Funktion | Parameter | Rückgabewert |
|---|---|---|
AddHours |
DateTime date, double value |
DateTime |
Fügt dem Datum date die bestimmte Anzahl an Stunden (value) zu und gibt ein neues Datum zurück.
Beispiel:
AddHours(new DateTime(2024,4,2,5,30,5), 1) = 02.04.2024 06:30:05
AddHours(ToDateTime("2.4.2024 5:30:05"), 1) = 02.04.2024 06:30:05
AddHours([Employees.BirthDate], 1) = 27.01.1986 01:00:00
AddMinutes
| Funktion | Parameter | Rückgabewert |
|---|---|---|
AddMinutes |
DateTime date, double value |
DateTime |
Fügt dem Datum date die bestimmte Anzahl an Minuten (value) zu und gibt ein neues Datum zurück.
Beispiel:
AddMinutes(new DateTime(2024,4,2,5,30,5), 10) = 02.04.2024 05:40:05
AddMinutes(ToDateTime("2.4.2024 5:30:05"), 10) = 02.04.2024 05:40:05
AddMinutes([Employees.BirthDate], 10) = 27.01.1986 00:10:00
AddMonth
| Funktion | Parameter | Rückgabewert |
|---|---|---|
AddMonths |
DateTime date, int value |
DateTime |
Fügt dem Datum date die spezifizierte Anzahl an Monaten (value) zu und gibt ein neues Datum zurück.
Beispiel:
AddMonths(new DateTime(2024,4,2,5,30,5), 2) = 02.06.2024 05:30:05
AddMonths(ToDateTime("2.4.2024 5:30:05"), 2) = 02.06.2024 05:30:05
AddMonths([Employees.BirthDate], 2) = 27.03.1986 00:00:00
AddSeconds
| Funktion | Parameter | Rückgabewert |
|---|---|---|
AddSeconds |
DateTime date, double value |
DateTime |
Fügt dem Datum date die besimmte Anzahl an Sekunden (value) zu und gibt ein neues Datum zurück.
Beispiel:
AddSeconds(new DateTime(2024,4,2,5,30,5), 10) = 02.04.2024 05:30:15
AddSeconds(ToDateTime("2.4.2024 5:30:05"), 10) = 02.04.2024 05:30:15
AddSeconds([Employees.BirthDate], 10) = 27.01.1986 00:00:10
AddYears
| Funktion | Parameter | Rückgabewert |
|---|---|---|
AddYears |
DateTime date, int value |
DateTime |
Fügt dem Datum date die bestimmte Anzahl an Jahren (value) zu und gibt ein neues Datum zurück.
Beispiel:
AddYears(new DateTime(2024,4,2,5,30,5), 3) = 02.04.2027 05:30:05
AddYears(ToDateTime("2.4.2024 5:30:05"), 3) = 02.04.2027 05:30:05
AddYears([Employees.BirthDate], 3) = 27.01.1989 00:00:00
DateDiff
| Funktion | Parameter | Rückgabewert |
|---|---|---|
DateDiff |
DateTime date1, DateTime date2 |
TimeSpan |
Gibt das Intervall (Anzahl an Tagen, Stunden, Minuten, Sekunden) zwischen zwei Datumsangaben zurück.
Beispiel:
DateDiff(new DateTime(2024,4,2,5,0,0), new DateTime(2025,1,2,5,30,5)) = -275.00:30:05
DateDiff(ToDateTime("2.1.2025 5:30:05"), ToDateTime("2.4.2024 5:00:00")) = 275.00:30:05
DateDiff(ToDateTime("2.4.2024 5:00:00"), [Employees.BirthDate]) = 13945.05:00:00
DateSerial
| Funktion | Parameter | Rückgabewert |
|---|---|---|
DateSerial |
int year, int month, int day |
DateTime |
Erstellt einen neuen DateTime-Wert für das festgelegte Jahr, den Monat und/oder Tag.
Eine weitere Möglichkeit, ein bestimmtes Datum festzulegen.
Beispiel:
DateSerial(2024,4,2) = 02.04.2024 00:00:00
Day
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Day |
DateTime date |
int |
Holt den Tag des Monats (1-31), dasdurch ein bestimmtes Datum repräsentiert wird.
Beispiel:
Day(new DateTime(2024,4,2)) = 2
Day(ToDateTime("2.4.2024")) = 2
Day([Employees.BirthDate]) = 27
DayofWeek
| Funktion | Parameter | Rückgabewert |
|---|---|---|
DayOfWeek |
DateTime date |
string |
Holt den lokalisierten Namen des Wochentages, der durch ein bestimmtes Datum repräsentiert wird.
Beispiel:
DayOfWeek(new DateTime(2024,4,2)) = "Dienstag"
DayOfWeek(ToDateTime("2.4.2024")) = "Dienstag"
DayOfWeek([Employees.BirthDate]) = "Montag"
DayOfYear
| Funktion | Parameter | Rückgabewert |
|---|---|---|
DayOfYear |
DateTime date |
int |
Holt den Tag des Jahres (1-365), der durch ein bestimmtes Datum repräsentiert wird.
Beispiel:
DayOfYear(new DateTime(2024,4,2)) = 93
DayOfYear(ToDateTime("2.4.2024")) = 93
DayOfYear([Employees.BirthDate]) = 27
DaysInMonth
| Funktion | Parameter | Rückgabewert |
|---|---|---|
DaysInMonth |
int year, int month |
int |
Gibt die Anzahl der Tage in einem bestimmten Monat oder Jahr zurück.
Beispiel:
DaysInMonth(2024, 4) = 30
Stunden
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Hour |
DateTime date |
int |
Holt die Stundenkomponente (0-23), die durch ein bestimmtes Datum repräsentiert wird.
Beispiel:
Hour(new DateTime(2024,4,2,5,30,5)) = 5
Hour(ToDateTime("2.4.2024 5:30:05")) = 5
Hour([Employees.BirthDate]) = 0
Minute
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Minute |
DateTime date |
int |
Holt die Minutenkomponente (0-59), die durch bestimmtes Datum repräsentiert wird.
Beispiel:
Minute(new DateTime(2024,4,2,5,30,5)) = 30
Minute(ToDateTime("2.4.2024 5:30:05")) = 30
Minute([Employees.BirthDate]) = 0
Month
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Month |
DateTime date |
int |
Holt die Monatskomponente (1-12), die durch ein bestimmtes Datum repräsentiert wird.
Beispiel:
Month(new DateTime(2024,4,2)) = 4
Month(ToDateTime("2.4.2024")) = 4
Month([Employees.BirthDate]) = 1
MonthName
| Funktion | Parameter | Rückgabewert |
|---|---|---|
MonthName |
int month |
string |
Holt den lokalisierten Namen des bestimmten Monats (1-12).
Beispiel:
MonthName(1) = "April"
Sekunde
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Second |
DateTime date |
int |
Holt die Sekundenkomponente (0-59), die durch ein bestimmtes Datum repräsentiert wird.
Beispiel:
Second(new DateTime(2024,4,2,5,30,5)) = 5
Second(ToDateTime("2.4.2024 5:30:05")) = 5
Second([Employees.BirthDate]) = 0
Year
| Funktion | Parameter | Rückgabewert |
|---|---|---|
Year |
DateTime date |
int |
Holt die Jahreskomponente, die durch ein bestimmtes Datum repräsentiert wird.
Beispiel:
Year(new DateTime(2024,4,2)) = 2024
Year(ToDateTime("2.4.2024")) = 2024
Year([Employees.BirthDate]) = 1986