> For the complete documentation index, see [llms.txt](https://docs.videc.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.videc.de/acron-9.3/intro/funktionen/funk_datum.md).

# Funktionen Datum

Die Gruppe Datumsfunktionen enthält Funktionen, mit denen Sie Zeitwerte als Datum interpretieren und bearbeiten. Fast alle Funktionen erwarten als Argument einen oder mehrere Zeitwerte beziehungsweise liefern als Ergebnis einen Zeitwert. In der Gruppe finden Sie die folgenden Funktionen:

In der Tabelle finden Sie in der ersten Spalte den Namen der Funktion, so wie Sie ihn in einem Ausdruck eingeben. In der zweiten Spalte finden Sie die Datentypen des oder der Argumente und in der dritten Spalte steht der Datentyp des Rückgabewerts der Funktion.

| Funktion                         | Argumente                      | Rückgabewert |
| -------------------------------- | ------------------------------ | ------------ |
| [AddDays](#func_adddays)         | (ZEITWERT, ZAHL)               | ZEITWERT     |
| [AddMonths](#func_addmonths)     | (ZEITWERT, ZAHL)               | ZEITWERT     |
| [AddWeeks](#func_addweeks)       | (ZEITWERT, ZAHL)               | ZEITWERT     |
| [AddYears](#func_addyears)       | (ZEITWERT, ZAHL)               | ZEITWERT     |
| [DateInRange](#func_dateinrange) | (ZEITWERT, ZEITWERT, ZEITWERT) | ZEITWERT     |
| [DateToNum](#func_datetonum)     | (ZEITWERT)                     | ZAHL         |
| [DateYMD](#func_dateymd)         | (ZAHL, ZAHL, ZAHL)             | ZEITWERT     |
| [Day](#func_day)                 | (ZEITWERT)                     | ZAHL         |
| [DoW](#func_dow)                 | (ZEITWERT)                     | ZAHL         |
| [Month](#func_month)             | (ZEITWERT)                     | ZAHL         |
| [NumToDate](#func_numtodate)     | (ZAHL)                         | ZEITWERT     |
| [Today](#func_today)             | ()                             | ZEITWERT     |
| [WeekDay](#func_weekday)         | (ZEITWERT)                     | ZAHL         |
| [WeekNo](#func_weekno)           | (ZEITWERT)                     | ZAHL         |
| [Year](#func_year)               | (ZEITWERT)                     | ZAHL         |

Eventuell sind nicht alle Funktionen dieser Gruppe in der von Ihnen verwendeten Anwendung verfügbar. Die Anwendung kann einzelne Funktionen beziehungsweise ganze Funktionsgruppen innerhalb des Formeleditors deaktivieren. Dies sind normalerweise Funktionen, die innerhalb der Anwendung nicht benötigt werden, da z.B. ein bestimmter Datentyp nicht verwendet wird.

## Funktion AddDays <a href="#func_adddays" id="func_adddays"></a>

|               |                                                                                                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT AddDays (ZEITWERT, Offset)                                                                                                                                 |
| Parameter:    | <ul><li>Das zu verschiebende Datum.</li><li>Der Offset (positiv oder negativ), um den das angegebene Datum des ersten Arguments verschoben werden soll.</li></ul>   |
| Rückgabewert: | Der neue Zeitwert, nachdem das erste Argument um die angegebene Anzahl Tage verschoben wurde.                                                                       |
| Beschreibung: | Die Funktion addiert die im 2. Parameter angegebene Anzahl Tage zu dem übergebenen Zeitwert. Die Funktion berücksichtigt automatisch die Monats- und Jahresgrenzen. |
| Beispiel:     | <p>Day (AddDays (Today (), -4)) = 6</p><p>Month (AddDays (Today (), -11)) = 2</p><p>wenn Today () z.B. der 10.03.2019 wäre</p>                                      |

## Funktion AddMonths <a href="#func_addmonths" id="func_addmonths"></a>

|               |                                                                                                                                                                                 |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT AddMonths (ZEITWERT, Offset)                                                                                                                                           |
| Parameter:    | <ul><li>Wert, dessen Monat verändert werden soll.</li><li>Der Offset (positiv oder negativ), um den die Anzahl Monate des ersten Arguments verschoben werden sollen.</li></ul>  |
| Rückgabewert: | Der neue Zeitwert, nachdem das erste Argument um die angegebene Anzahl Monate verschoben wurde.                                                                                 |
| Beschreibung: | Die Funktion addiert die im 2. Parameter angegebene Anzahl Monate zu dem übergebenen Zeitwert. Die Funktion berücksichtigt automatisch die Jahresgrenzen.                       |
| Beispiel:     | <p>Day (AddMonths (Today (), -4)) = 2</p><p>Month (AddMonths (Today (), -4)) = 11</p><p>Year (AddMonths (Today (), -4)) = 2018</p><p>wenn Today () z.B. der 02.03.2019 wäre</p> |

## Funktion AddWeeks <a href="#func_addweeks" id="func_addweeks"></a>

|               |                                                                                                                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT AddWeeks (ZEITWERT, Offset)                                                                                                                                                |
| Parameter:    | <ul><li>Wert, für den die Woche verändert werden soll.</li><li>Der Offset (positiv oder negativ), um den die Anzahl Wochen des ersten Arguments verschoben werden sollen.</li></ul> |
| Rückgabewert: | Der neue Zeitwert, nachdem das erste Argument um die angegebene Anzahl Wochen verschoben wurde.                                                                                     |
| Beschreibung: | Die Funktion addiert die im 2. Parameter angegebene Anzahl Wochen zu dem übergebenen Zeitwert. Die Funktion berücksichtigt automatisch die Monats- und Jahresgrenzen.               |
| Beispiel:     | <p>Day (AddWeeks (Today (), -4)) = 2</p><p>Month (AddWeeks (Today (), -4)) = 2</p><p>Year (AddWeeks (Today (), -4)) = 2019</p><p>wenn Today () z.B. der 02.03.2019 wäre</p>         |

## Funktion AddYears <a href="#func_addyears" id="func_addyears"></a>

|               |                                                                                                                                                                                   |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT AddYears (ZEITWERT, Offset)                                                                                                                                              |
| Parameter:    | <ul><li>Wert, für den das Jahr verändert werden soll.</li><li>Der Offset (positiv oder negativ), um den die Anzahl Jahre des ersten Arguments verschoben werden sollen.</li></ul> |
| Rückgabewert: | Der neue Zeitwert, nachdem das erste Argument um die angegebene Anzahl Jahre verschoben wurde.                                                                                    |
| Beschreibung: | Die Funktion addiert die im 2. Parameter angegebene Anzahl Jahre zu dem übergebenen Zeitwert. Die Funktion berücksichtigt automatisch Schaltjahre.                                |
| Beispiel:     | <p>Day (AddYears (Today (), -4)) = 2</p><p>Month (AddYears (Today (), -4)) = 3</p><p>Year (AddYears (Today (), -4)) = 2015</p><p>wenn Today () z.B. der 02.03.2019 wäre</p>       |

## Funktion DateInRange <a href="#func_dateinrange" id="func_dateinrange"></a>

|               |                                                                                                                                                                                                                                                      |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | BOOL DateInRange (ZEITWERT, Minimum, Maximum)                                                                                                                                                                                                        |
| Parameter:    | <ul><li>Zu prüfendes Datum.</li><li>Untergrenze des zu prüfenden Intervalls.</li><li>Obergrenze des zu prüfenden Intervalls.</li></ul>                                                                                                               |
| Rückgabewert: | Liefert TRUE, wenn sich das 1. Argument innerhalb des Intervalls befindet. Ist das Datum außerhalb der Grenzen, liefert die Funktion FALSE.                                                                                                          |
| Beschreibung: | Testet, ob sich das Datum innerhalb der Intervallgrenzen aus dem 2. und 3. Argument befindet. Das Intervall ist abgeschlossen, d.h., ein Wert, der auf einer der beiden Grenzen liegt, ist noch innerhalb der Grenzen und die Funktion liefert TRUE. |
| Siehe auch:   | [Funktion NumInRange](/acron-9.3/intro/funktionen/funk_mathe.md#func_numinrange), [Funktion TimeInRange](/acron-9.3/intro/funktionen/funk_zeit.md#func_timeinrange)                                                                                  |

## Funktion DateToNum <a href="#func_datetonum" id="func_datetonum"></a>

|               |                                                                                                                                                                                                                                                                                                                                                                            |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZAHL DateToNum (ZEITWERT)                                                                                                                                                                                                                                                                                                                                                  |
| Parameter:    | <ul><li>Zeitwert, der in eine Zahl konvertiert werden soll.</li></ul>                                                                                                                                                                                                                                                                                                      |
| Rückgabewert: | Eine normale Zahl, die dem übergebenen Zeitwert entspricht.                                                                                                                                                                                                                                                                                                                |
| Beschreibung: | <p>Die Funktion konvertiert einen Zeitwert in eine normale Zahl.</p><p>Damit Sie Zeitwerte (Datum und/oder Uhrzeit) in den mathematischen Funktionen verwenden oder mit konstanten Werten vergleichen können, müssen Sie diese in eine Zahl konvertieren.</p><p>Eine Zahl konvertieren Sie mit der Funktion <a href="#func_numtodate">NumToDate</a> in einen Zeitwert.</p> |
| Beispiel:     | DateToNum (Today ()) == 90000000                                                                                                                                                                                                                                                                                                                                           |

## Funktion DateYMD <a href="#func_dateymd" id="func_dateymd"></a>

|               |                                                                                                                                                                                                                                                                                               |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT DateYMD (Jahr, Monat, Tag)                                                                                                                                                                                                                                                           |
| Parameter:    | <ul><li>Jahr seit 1970</li><li>Monat im Bereich 1 bis 12</li><li>Tag im Bereich 1 bis 31.</li></ul>                                                                                                                                                                                           |
| Rückgabewert: | Der Zeitwert, der dem angegebenen Datum um 00:00 Uhr entspricht.                                                                                                                                                                                                                              |
| Beschreibung: | Die Funktion konvertiert das in den Argumenten angegebene Datum in einen Zeitwert. Wird für das Argument ein ungültiger Wert übergeben (z.B. der 30.02), passt die Funktion den Monat und den Tag entsprechend an. D.h., aus dem 30.02. wird der 1. oder 2. März (abhängig von Schaltjahren). |
| Beispiel:     | if (DateYMD (2019,3,20) == Today (), TRUE, FALSE)                                                                                                                                                                                                                                             |
| Siehe auch:   | [Funktion TimeHMS](/acron-9.3/intro/funktionen/funk_zeit.md#func_timehms)                                                                                                                                                                                                                     |

## Funktion Day <a href="#func_day" id="func_day"></a>

|               |                                                                                          |
| ------------- | ---------------------------------------------------------------------------------------- |
| Syntax:       | ZAHL Day (ZEITWERT)                                                                      |
| Parameter:    | <ul><li>Angabe des Datums, zu dem der Tag ermittelt werden soll.</li></ul>               |
| Rückgabewert: | Den Tag des Monats (1 bis 31) für das angegebene Datum.                                  |
| Beschreibung: | Die Funktion ermittelt den Tag innerhalb des Monats zu dem angegeben Datum als Zeitwert. |
| Beispiel:     | <p>Day (Today ()) == 31</p><p>Wenn heute z.B. der 31. März 2019 wäre.</p>                |

## Funktion Dow <a href="#func_dow" id="func_dow"></a>

|               |                                                                                                                                                     |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZAHL Dow (ZEITWERT)                                                                                                                                 |
| Parameter:    | <ul><li>Datumsangabe als Zeitwert.</li></ul>                                                                                                        |
| Rückgabewert: | Tag der Woche.                                                                                                                                      |
| Beschreibung: | Ermittelt den Wochentag für das als Argument übergebene Datum und gibt diesen als Zahl im Bereich von 0 bis 6 zurück. Die 0 entspricht dem Sonntag. |
| Beispiel:     | Dow (DateYMD (2019, 31, 3)) = 0                                                                                                                     |
| Siehe auch:   | [Funktion WeekDay](#func_weekday)                                                                                                                   |

## Funktion Month <a href="#func_month" id="func_month"></a>

|               |                                                                              |
| ------------- | ---------------------------------------------------------------------------- |
| Syntax:       | ZAHL Month (ZEITWERT)                                                        |
| Parameter:    | <ul><li>Angabe des Datums, zu dem der Monat ermittelt werden soll.</li></ul> |
| Rückgabewert: | Der Monat (1 bis 12) für das angegebene Datum.                               |
| Beschreibung: | Die Funktion ermittelt den Monat zu dem angegeben Datum als Zeitwert.        |
| Beispiel:     | <p>Month (Today ()) = 3</p><p>Wenn heute z.B. der 31. März 2019 wäre.</p>    |

## Funktion NumToDate <a href="#func_numtodate" id="func_numtodate"></a>

|               |                                                                                                                                                                                                                                                                                                                             |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT NumToDate (ZAHL)                                                                                                                                                                                                                                                                                                   |
| Parameter:    | <ul><li>Zahl, die in einen Zeitwert konvertiert werden soll.</li></ul>                                                                                                                                                                                                                                                      |
| Rückgabewert: | Der Zeitwert, der der übergebenen Zahl entspricht.                                                                                                                                                                                                                                                                          |
| Beschreibung: | <p>Die Funktion konvertiert eine normale Zahl in einen Zeitwert.</p><p>Damit Sie normale Zahlen mit den Funktionen für Datum und/oder Uhrzeit verwenden können, müssen Sie diese in einen Zeitwert konvertieren. Einen Zeitwert konvertieren Sie mit der Funktion <a href="#func_datetonum">DateToNum</a> in eine Zahl.</p> |

## Funktion Today <a href="#func_today" id="func_today"></a>

|               |                                                                           |
| ------------- | ------------------------------------------------------------------------- |
| Syntax:       | ZEITWERT Today ()                                                         |
| Parameter:    | <ul><li>Keiner.</li></ul>                                                 |
| Rückgabewert: | Der Zeitwert des aktuellen Datums.                                        |
| Beschreibung: | Die Funktion liefert den Zeitwert des aktuellen Tages 00:00 Uhr.          |
| Beispiel:     | <p>Day (Today ()) == 31</p><p>Wenn heute z.B. der 31. März 2019 wäre.</p> |

## Funktion WeekDay <a href="#func_weekday" id="func_weekday"></a>

|               |                                                                                                                                                     |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Syntax:       | ZAHL WeekDay (ZEITWERT)                                                                                                                             |
| Parameter:    | <ul><li>Datumsangabe als Zeitwert.</li></ul>                                                                                                        |
| Rückgabewert: | Tag der Woche.                                                                                                                                      |
| Beschreibung: | Ermittelt den Wochentag für das als Argument übergebene Datum und gibt diesen als Zahl im Bereich von 0 bis 6 zurück. Die 0 entspricht dem Sonntag. |
| Beispiel:     | WeekDay (DateYMD (2019, 31, 3)) == 3                                                                                                                |
| Siehe auch:   | [Funktion DoW](#func_dow)                                                                                                                           |

## Funktion WeekNo <a href="#func_weekno" id="func_weekno"></a>

|               |                                                              |
| ------------- | ------------------------------------------------------------ |
| Syntax:       | ZAHL WeekNo (ZEITWERT)                                       |
| Parameter:    | <ul><li>Zeitwert mit dem Datum für die Berechnung.</li></ul> |
| Rückgabewert: | Die ISO Wochennummer für das angegebene Datum (1-53).        |
| Beschreibung: | Ermittelt die ISO Wochennummer zu einer Datumsangabe.        |
| Beispiel:     | WeekNo (DateYMD (2019, 3, 31)) == 13                         |

## Funktion Year <a href="#func_year" id="func_year"></a>

|               |                                                                              |
| ------------- | ---------------------------------------------------------------------------- |
| Syntax:       | ZAHL Year (ZEITWERT)                                                         |
| Parameter:    | <ul><li>Angabe des Datums, zu dem das Jahr ermittelt werden soll.</li></ul>  |
| Rückgabewert: | Das Jahr für das angegebene Datum.                                           |
| Beschreibung: | Die Funktion ermittelt das Jahr zu dem angegeben Datum als Zeitwert.         |
| Beispiel:     | <p>Year (Today ()) == 2019</p><p>Wenn heute z.B. der 31. März 2019 wäre.</p> |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.videc.de/acron-9.3/intro/funktionen/funk_datum.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.