Gebruiksvoorbeeld
Syntaxis
Parameters
date_expression: Een veld of expressie voor Datum of Datum en tijd. Als de 1e datumexpressie vóór de 2e datumexpressie ligt, is het resultaat nul of negatief.part: Het tijdsdeel dat wordt geretourneerd.DATETIME_DIFFondersteunt de volgende delen:MICROSECOND: Beschikbaar voor de velden of expressies Datum en tijd.MILLISECOND: Beschikbaar voor de velden of expressies Datum en tijd.SECOND: Beschikbaar voor de velden of expressies Datum en tijd.MINUTE: Beschikbaar voor de velden of expressies Datum en tijd.HOUR: Beschikbaar voor de velden of expressies Datum en tijd.DAYWEEK: Dit datumdeel begint op zondag.ISOWEEK: Gebruikt ISO 8601-weekgrenzen. ISO-weken beginnen op maandag.MONTHQUARTERYEARISOYEAR: Gebruikt de ISO 8601-jaargrens gebaseerd op weeknummer. De ISO-jaargrens is de maandag van de 1e week waarvan de donderdag bij het bijbehorende Gregoriaanse kalenderjaar hoort.
Type geretourneerde gegevens
Getal (geheel)
Voorbeelden
In het 2e en 3e voorbeeld hieronder staat het resultaat van DATETIME_DIFF voor 2 datumwaarden die 24 uur uit elkaar liggen. DATETIME_DIFF met het deel WEEK retourneert 1 omdat DATETIME_DIFF het aantal deelgrenzen in dit bereik van datumwaarden telt. Elke WEEK begint op zondag, dus is er 1 deelgrens tussen zaterdag 14-10-2017 00:00:00 en zondag 15-10-2017 00:00:00.
| Example formula | Output |
|---|---|
DATETIME_DIFF( DATETIME "2010-07-07 10:20:00", DATETIME "2008-12-25 15:30:00", DAY ) |
559 |
DATETIME_DIFF( DATETIME "2017-10-15 00:00:00", DATETIME "2017-10-14 00:00:00", DAY ) |
1 |
DATETIME_DIFF( DATETIME "2017-10-15 00:00:00", DATETIME "2017-10-14 00:00:00", WEEK ) |
1 |
In het volgende voorbeeld staat het resultaat van DATETIME_DIFF voor 2 datums in verschillende jaren. DATETIME_DIFF met het datumdeel YEAR retourneert 3 omdat dit het aantal jaargrenzen van het Gregoriaanse kalenderjaar tussen de 2 datumwaarden telt. DATETIME_DIFF met het datumdeel ISOYEAR retourneert 2 omdat de 2e datumwaarde bij het ISO-jaar 2015 hoort. De 1e donderdag van het kalenderjaar van 2015 was 01-01-2015, dus het ISO-jaar 2015 begint op de maandag die hieraan vooraf gaat: 29-12-2014.
| Example formula | Output |
|---|---|
DATETIME_DIFF(DATETIME '2017-12-30 00:00:00', DATETIME '2014-12-30 00:00:00', YEAR) |
3 |
DATETIME_DIFF(DATETIME '2017-12-30 00:00:00', DATETIME '2014-12-30 00:00:00', ISOYEAR) |
2 |
In het volgende voorbeeld staat het resultaat van DATETIME_DIFF voor 2 achtereenvolgende dagen. De 1e datum valt op een maandag en de 2e op een zondag. DATETIME_DIFF met het datumdeel ISOWEEK retourneert ook 1 omdat ISO-weken op maandag beginnen.
| Example formula | Output |
|---|---|
DATETIME_DIFF(DATE '2017-12-18', DATE '2017-12-17', WEEK) |
0 |
DATETIME_DIFF(DATE '2017-12-18', DATE'2017-12-17', ISOWEEK) |
1 |
Opmerkingen
Deze functie is niet beschikbaar voor datumtypen in compatibiliteitsmodus.