De klasse BirtDateTime biedt functies voor het bepalen van de hoeveelheid tijd tussen twee datums of tijdstippen, voor het groter of kleiner maken van perioden en voor het ophalen van delen van een datum. Aangezien tijdsperioden gewoon getallen zijn, kan de toepassing er normale
wiskundige berekeningen mee uitvoeren: vermenigvuldigen, delen, optellen, aftrekken etc.
Dit is een statische klasse. De toepassing kan geen instances van de klasse maken.
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal dagen en een bepaalde datum. Het aantal toe te voegen dagen kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Datumobject. Een datumobject dat de begindatum aangeeft.
n
Getalsobject. Het aantal dagen dat bij de datum moet worden opgeteld. Decimale getallen worden behandeld als gehele getallen, afgerond op het onderliggende gehele getal.
Resultaat
Datumobject. Een datum die het resultaat is van het optellen van het aantal dagen bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden er dagen opgeteld bij een specifieke datum:
In het volgende voorbeeld worden 15 dagen opgeteld bij elke datumwaarde in het veld RekeningDatum:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal uren en een bepaalde datum. Het aantal toe te voegen uren kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Een datumobject dat de begindatum aangeeft. Als de begindatum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).
n
Getalsobject. Het aantal uren dat bij de datum moet worden opgeteld.
Resultaat
Datumobject. Een datum die het resultaat is van het optellen van het aantal uren bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden uren opgeteld bij een specifieke datum en tijd:
In het volgende voorbeeld worden 36 uren opgeteld bij elke datumwaarde in het veld StartTijd:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal minuten en een bepaalde datum. Het aantal toe te voegen minuten kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Een datumobject dat de begindatum aangeeft. Als de begindatum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).
n
Getalsobject. Het aantal minuten dat bij de datum moet worden opgeteld.
Resultaat
Datumobject. Een datum die het resultaat is van het optellen van het aantal minuten bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden minuten opgeteld bij een specifieke datum en tijd:
In het volgende voorbeeld worden 15 minuten opgeteld bij elke datumwaarde in het veld StartTijd:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal maanden en een bepaalde datum. Het aantal toe te voegen maanden kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Deze functie levert altijd een geldige datum op. Als het nodig is, kan het daggedeelte van de geretourneerde datum worden vervangen door de laatste dag van de geretourneerde maand in het geretourneerde jaar. U kunt bijvoorbeeld een maand optellen bij 31 januari 2008, addMonth( ) retourneert 29 februari 2008 (2008 is een schrikkeljaar), in plaats van 31 februari 2008.
Syntaxis
Parameters
datum
Datumobject. Een datumobject dat de begindatum aangeeft.
n
Getalsobject. Het aantal maanden dat bij de datum moet worden opgeteld. Decimale getallen worden behandeld als gehele getallen, naar beneden afgerond.
Resultaat
Datumobject. Een datum die het resultaat is van het optellen van het aantal maanden bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden er maanden opgeteld bij een specifieke datum:
In het volgende voorbeeld worden 10 maanden opgeteld bij elke datumwaarde in het veld RekeningDatum:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal kwartalen en een bepaalde datum. Een kwartaal is gelijk aan drie maanden.
Als u bijvoorbeeld twee kwartalen optelt bij 10 september 2008, geeft de functie het
resultaat 10 maart 2009. Het aantal toe te voegen kwartalen kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Een datumobject dat de begindatum aangeeft.
n
Getalsobject. Het aantal kwartalen dat bij de datum moet worden opgeteld.
Resultaat
Datumobject. Een datum die het resultaat is van het optellen van het aantal kwartalen bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden kwartalen opgeteld bij een specifieke datum:
In het volgende voorbeeld worden 2 kwartalen opgeteld bij elke datumwaarde in het veld ForecastClosing:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal seconden en een bepaalde datum. Het aantal toe te voegen seconden kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Een datumobject dat de begindatum aangeeft. Als de begindatum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).
n
Getalsobject. Het aantal seconden dat bij de datum moet worden opgeteld.
Resultaat
Datumobject. Het resultaat van het optellen van het gespecificeerde aantal seconden bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden er seconden opgeteld bij een specifieke datum en tijd:
In het volgende voorbeeld worden 6000 seconden opgeteld bij elke datumwaarde in het veld StartTime:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal weken en een bepaalde datum. Het aantal toe te voegen weken kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Een datumobject dat de begindatum aangeeft.
n
Getalsobject. Het aantal weken dat bij de datum moet worden opgeteld.
Resultaat
Datumobject. Een datum die het resultaat is van het optellen van het aantal weken bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden weken opgeteld bij een specifieke datum:
In het volgende voorbeeld worden 2 weken opgeteld bij elke datumwaarde in het veld RekeningDatum:
Deze functie resulteert in een nieuwe datum, die de som is van een gegeven aantal jaren en een bepaalde datum. Het aantal toe te voegen jaren kan negatief zijn. In zo'n geval wordt het aantal afgetrokken van de datum.
Syntaxis
Parameters
datum
Een datumobject dat de begindatum aangeeft.
n
Getalsobject. Het aantal jaren dat bij de datum moet worden opgeteld. Decimale getallen worden behandeld als gehele getallen, naar beneden afgerond.
Resultaat
Een datum die het resultaat is van het optellen van het aantal jaren bij de begindatum.
Voorbeelden
In het volgende voorbeeld worden jaren opgeteld bij een specifieke datum:
In het volgende voorbeeld worden 5 jaren opgeteld bij elke datumwaarde in het veld HireDate:
Deze functie geeft als resultaat een getal van 1 tot 31 dat de dag van de maand voor een bepaalde datum aangeeft. Als de datum bijvoorbeeld 19-01-2009 is, retourneert de functie de waarde 19.
Syntaxis
Parameter
datum
Datumobject. Een datumobject waaruit de dag wordt opgehaald.
Resultaat
Een geheel getal dat voor een bepaalde de dag van de maand datum aangeeft.
Voorbeelden
In het volgende voorbeeld is het resultaat de dag van de maand voor elke waarde in het veld ShipDate:
In het volgende voorbeeld is het resultaat de dag van de maand voor de huidige datum:
Deze functie berekent het aantal dagen tussen twee datums. Een dag wordt berekend door de dagwaarde van de eerste datum af te trekken van de dagwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 30-12-2008 23:59:59 is en de tweede datum 31-12-2008 00:00:00, geeft de functie als resultaat 1 dag, ondanks dat er slechts één seconde tussen de tijdstippen ligt.
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal dagen tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal dagen tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal dagen tussen de huidige datum en het einde van 2009:
Het resultaat van het volgende voorbeeld is het aantal dagen tussen de velden InvoiceDate en PaymentDate:
Deze functie berekent het aantal uren tussen twee datums. Een uur wordt berekend door de uurwaarde van de eerste datum af te trekken van de uurwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 31-01-2009 1:30:00 is en de tweede datum 31-01-2008 2:00:00, geeft de functie als resultaat 1 uur, ondanks dat er slechts 30 minuten tussen de datums liggen. Als de datum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal uren tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal uren tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal uren tussen de huidige datum en tijd en het einde van 2009:
Het resultaat van het volgende voorbeeld is het aantal uren tussen de velden StartTime en FinishTime:
Deze functie berekent het aantal minuten tussen twee datums. Een minuut wordt berekend door de minuutwaarde van de eerste datum af te trekken van de minuutwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 31-01-2009 1:30:59 is en de tweede datum 31-01-2009 1:31:00, geeft de functie als resultaat 1 minuut, ondanks dat er slechts één seconde tussen de datums ligt. Als de datum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal minuten tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal minuten tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal minuten tussen de huidige datum en tijd en het begin van 2010:
Het resultaat van het volgende voorbeeld is het aantal minuten tussen de velden StartTime en FinishTime:
Deze functie berekent het aantal maanden tussen twee datums. Een maand wordt berekend door de maandwaarde van de eerste datum af te trekken van de maandwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 31-01-2009 is en de tweede datum 01-02-2009, geeft de functie als resultaat 1 maand, ondanks dat er slechts één dag tussen de datums ligt.
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal maanden tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal maanden tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal maanden tussen de huidige datum en het begin van 2010:
Het resultaat van het volgende voorbeeld is het aantal maanden tussen de velden ProjectStart en ProjectComplete:
Deze functie berekent het aantal kwartalen tussen twee datums. Een kwartaal wordt berekend door de maandwaarde van de eerste datum af te trekken van de maandwaarde van de tweede datum. Een verschil van drie maanden is gelijk aan een kwartaal. Als de eerste datum bijvoorbeeld 31-01-2009 is en de tweede datum 01-07-2009, geeft de functie als resultaat 2. Als de eerste datum 01-01-2008 is en de tweede datum 30-09-2009, retourneert de functie eveneens 2.
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal kwartalen tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal kwartalen tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal kwartalen tussen de huidige datum en het begin van 2010:
Het resultaat van het volgende voorbeeld is het aantal kwartalen tussen de velden ProjectStart en ProjectComplete:
Deze functie berekent het aantal seconden tussen twee datums. Als de datum geen tijdwaarde heeft, gaat de functie ervan uit dat het middernacht is (00:00:00).
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal seconden tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal seconden tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal seconden tussen de huidige datum en tijd en het begin van 2010:
Het resultaat van het volgende voorbeeld is het aantal seconden tussen de velden StartTime en FinishTime:
Deze functie berekent het aantal weken tussen twee datums. Een week wordt berekend door het weeknummer van de eerste datum af te trekken van het weeknummer van de tweede datum. Als de eerste datum bijvoorbeeld 02-01-2009 is (week 1 van het jaar) en de tweede datum 05-01-2009 (week 2 van het jaar), geeft de functie als resultaat 1 week, ondanks dat er slechts drie dagen tussen de datums liggen.
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal weken tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal weken tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal weken tussen de huidige datum en het begin van 2010:
Het resultaat van het volgende voorbeeld is het aantal weken tussen de velden ProjectStart en ProjectComplete:
Deze functie berekent het aantal jaren tussen twee datums. Een jaar wordt berekend door de jaarwaarde van de eerste datum af te trekken van de jaarwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 01-01-2009 is en de tweede datum 31-12-2009, geeft de functie als resultaat 0. Als de eerste datum 15-11-2008 is en de tweede datum 15-01-2009, retourneert de functie 1.
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal jaren tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal jaren tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal jaren tussen elke waarde in het veld HireDate en de huidige datum:
Deze functie berekent het aantal jaren tussen twee datums. Een jaar wordt berekend door de jaarwaarde van de eerste datum af te trekken van de jaarwaarde van de tweede datum. Als de eerste datum bijvoorbeeld 01-01-2009 is en de tweede datum 31-12-2009, geeft de functie als resultaat 0. Als de eerste datum 15-11-2008 is en de tweede datum 15-01-2009, retourneert de functie 1.
Syntaxis
Parameters
datum1
Een datumobject dat het begin van een tijdsperiode aangeeft.
datum2
Een datumobject dat het einde van een tijdsperiode aangeeft.
Resultaat
Geheel getal. Het aantal jaren tussen twee datums.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal jaren tussen specifieke datums:
Het resultaat van het volgende voorbeeld is het aantal jaren tussen elke waarde in het veld HireDate en de huidige datum:
Deze functie retourneert de datum van de eerste dag van de maand waarin de invoerdatum valt.
Syntaxis
Parameters
datum
Een datumobject waaruit de maand wordt opgehaald.
Resultaat
Datumobject. De eerste dag van de maand voor een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de maandwaarden die worden geretourneerd voor een bepaalde datum:
Deze functie retourneert de datum van de eerste dag van het kwartaal waarin de invoerdatum valt.
Syntaxis
Parameters
datum
Een datumobject waaruit het kwartaalwordt opgehaald.
Resultaat
Datumobject. De eerste dag van het kwartaal voor een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de kwartaalwaarden die worden geretourneerd voor een bepaalde datum:
Deze functie retourneert de datum van de eerste dag van de week waarin de invoerdatum valt. De eerste dag van de week is altijd een zondag.
Syntaxis
Parameters
datum
Een datumobject waaruit de week wordt opgehaald.
Resultaat
Datumobject. De eerste dag van de week voor een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de weekwaarden die worden geretourneerd voor een bepaalde datum:
Deze functie retourneert de datum van de eerste dag van het jaar waarin de invoerdatum valt.
Syntaxis
Parameters
datum
Een datumobject waaruit het jaar wordt opgehaald.
Resultaat
Datumobject. De eerste dag van het jaar voor een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de jaarwaarden die worden geretourneerd voor een bepaalde datum:
Het resultaat van deze functie is de maand van een bepaalde datum. Afhankelijk van de gekozen optie, kan de functie de maand retourneren als getal, als volledige naam van de maand of als afgekorte naam. De naam van de maand is specifiek voor de gebruikte locale.
Syntaxis
Parameters
datum
Een datumobject waaruit de maand wordt opgehaald.
optie
Geheel getal. Optioneel. Een getal dat de geretourneerde maandnotatie aangeeft. Geef een van de volgende waarden op:
Als u dit argument weglaat, retourneert de functie de maand als getal.
Resultaat
Tekenreeks. De maand van een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de maandwaarden die worden geretourneerd voor een bepaalde datum:
In het volgende voorbeeld is het resultaat de maand voor de huidige datum:
Deze functie geeft als resultaat de huidige datum en tijd, bijvoorbeeld 2 feb 2009 2:05 PM.
Syntaxis
Resultaat
Datumobject. De actuele datum en tijd.
Voorbeeld
Het resultaat van het volgende voorbeeld is het aantal uren tussen de huidige datum en tijd en Kerstmis:
Deze functie geeft als resultaat een getal van 1 tot 4 dat het kwartaal voor een bepaalde datum aangeeft. Het eerste kwartaal begint op 1 januari.
Syntaxis
Parameter
date
Een datumobject waaruit het kwartaalnummer wordt opgehaald.
Resultaat
Geheel getal. Het kwartaalnummer van een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de kwartaalnummers die worden geretourneerd voor bepaalde datums:
In het volgende voorbeeld is het resultaat het kwartaal voor elke waarde in het veld CloseDate:
In het volgende voorbeeld is het resultaat het kwartaalnummer voor de huidige datum:
Deze functie geeft als resultaat de huidige datum die de tijdwaarde van middernacht bevat, bijvoorbeeld 2 feb 2009 00:00.
Syntaxis
Resultaat
Datumobject. De actuele datum, met als tijdswaarde middernacht.
Voorbeelden
Het resultaat van het volgende voorbeeld is het aantal dagen tussen de actuele datum en Kerstmis:
Het volgende voorbeeld berekent het aantal jaren tussen elke waarde in het veld HireDate en de huidige datum.
Deze functie geeft als resultaat een getal van 1 tot 52 dat het weeknummer van een bepaalde datum aangeeft.
Syntaxis
Parameter
datum
Een datumobject waaruit het weeknummer wordt opgehaald.
Resultaat
Geheel getal. Het weeknummer van een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de weeknummers die worden geretourneerd voor bepaalde datums:
In het volgende voorbeeld is het resultaat de week voor elke waarde in het veld CloseDate:
In het volgende voorbeeld is het resultaat het weeknummer voor de huidige datum:
Het resultaat van deze functie is de week van een bepaalde datum. Afhankelijk van de gekozen optie, kan de functie de dag van de week retourneren als getal, als volledige weekdagnaam of als afgekorte weekdagnaam. De naam van de weekdag is specifiek voor de gebruikte locale.
Syntaxis
Parameters
datum
Een datumobject waaruit de dag van de week wordt opgehaald.
optie
Geheel getal. Optioneel. Een getal dat de te retourneren notatie aangeeft. Geef een van de volgende waarden op:
Als u dit argument weglaat, maakt de functie gebruik van optie 1.
Resultaat
Tekenreeks. De dag van de week voor een bepaalde datum.
Voorbeelden
Het volgende voorbeeld toont de weekdagwaarden die worden geretourneerd voor een bepaalde datum:
In het volgende voorbeeld is het resultaat de weekdag voor de huidige datum:
Het resultaat van deze functie is het jaar in vier cijfers van een bepaalde datum. Als de datum bijvoorbeeld 19-01-2009 is, retourneert de functie de waarde 2009.
Syntaxis
Parameter
datum
Een datumobject waaruit het jaar wordt opgehaald.
Resultaat
Geheel getal. De uit vier cijfers bestaande waarde voor het jaar van een bepaalde datum.
Voorbeelden
In het volgende voorbeeld is het resultaat het jaar voor elke waarde in het veld HireDate:
In het volgende voorbeeld is het resultaat het jaar voor de huidige datum: