BirtDateTime-klassen har funksjoner som fastsetter hvor mye tid det er mellom to datoer eller klokkeslett, for å legge til eller trekke fra tidsrom, og for å hente deler av en dato. Siden datoer bare er tall, kan applikasjonen bruke vanlige regnefunksjoner på dem, det vil si multiplikasjon, divisjon, addisjon, subtraksjon og så videre. Denne klassen er statisk. Applikasjonen kan ikke opprette forekomster av klassen.
Denne funksjonen returnerer en ny dato som er summen når et gitt antall dager legges til en dato. Antall dager som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Datoobjekt. Et datoobjekt som representerer startdatoen.
n
Number-objekt. Antall dager som skal legges til datoen. Desimaltall behandles som heltall, avrundet ned til nærmeste heltall.
Returnerer
Datoobjekt. Den datoen som opprettes når det oppgitte antall dager legges til startdatoen.
Eksempler
Det følgende eksempelet legger dager til en bestemt dato:
Det følgende eksempelet legger 15 dager til hver datoverdi i InvoiceDate-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall timer legges til en dato. Antall timer som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Et datoobjekt som representerer startdatoen. Hvis en startdato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).
n
Number-objekt. Antall timer som skal legges til datoen.
Returnerer
Datoobjekt. Den datoen som opprettes når det oppgitte antall timer legges til startdatoen.
Eksempler
Det følgende eksempelet legger timer til en bestemt dato:
Det følgende eksempelet legger 36 dager til hver datoverdi i StartTime-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall minutter legges til en dato. Antall minutter som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Et datoobjekt som representerer startdatoen. Hvis en startdato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).
n
Number-objekt. Antall minutter som skal legges til datoen.
Returnerer
Datoobjekt. Den datoen som opprettes når det oppgitte antall minutter legges til startdatoen.
Eksempler
Det følgende eksempelet legger minutter til en bestemt dato:
Det følgende eksempelet legger 15 minutter til hver datoverdi i StartTime-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall måneder legges til en dato. Antall måneder som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Denne funksjonen returnerer alltid en gyldig dato. Hvis det er nødvendig, vil dagdelen av den resulterende datoen bli justert nedover til den siste dagen i den resulterende måneden i det resulterende året. Hvis du for eksempel legger 1 måned til 31. januar 2008, returnerer addMonth( ) 29. februar 2008 (2008 var et skuddår), ikke 31. februar 2008.
Syntaks
Parametere
date
Datoobjekt. Et datoobjekt som representerer startdatoen.
n
Number-objekt. Antall måneder som skal legges til datoen. Desimaltall behandles som heltall, avrundet nedover.
Returnerer
Datoobjekt. Den datoen som opprettes når det oppgitte antall måneder legges til startdatoen.
Eksempler
Det følgende eksempelet legger måneder til en bestemt dato:
Det følgende eksempelet legger 10 måneder til hver datoverdi i InvoiceDate-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall kvartaler legges til en dato. Et kvartal er lik tre måneder. Hvis du for eksempel legger 2 kvartaler til 10. september 2008, returnerer funksjonen 10. mars 2009. Antall kvartaler som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Et datoobjekt som representerer startdatoen.
n
Number-objekt. Antall kvartaler som skal legges til datoen.
Returnerer
Datoobjekt. Den datoen som opprettes når det oppgitte antall kvartaler legges til startdatoen.
Eksempler
Det følgende eksempelet legger kvartaler til en bestemt dato:
Det følgende eksempelet legger 2 kvartaler til hver datoverdi i ForecastClosing-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall sekunder legges til en dato. Antall sekunder som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Et datoobjekt som representerer startdatoen. Hvis en startdato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).
n
Number-objekt. Antall sekunder som skal legges til datoen.
Returnerer
Datoobjekt. Resultatet når det oppgitte antall sekunder legges til startdatoen.
Eksempler
Det følgende eksempelet legger sekunder til en bestemt dato:
Det følgende eksempelet legger 6000 sekunder til hver datoverdi i StartTime-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall uker legges til en dato. Antall uker som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Et datoobjekt som representerer startdatoen.
n
Number-objekt. Antall uker som skal legges til datoen.
Returnerer
Datoobjekt. Den datoen som opprettes når det oppgitte antall uker legges til startdatoen.
Eksempler
Det følgende eksempelet legger uker til en bestemt dato:
Det følgende eksempelet legger 2 uker til hver datoverdi i InvoiceDate-feltet:
Denne funksjonen returnerer en ny dato som er summen når et gitt antall år legges til en dato. Antall år som skal legges til, kan være negativt. I så fall er resultatet det samme som når dette tallet blir trukket fra datoen.
Syntaks
Parametere
date
Et datoobjekt som representerer startdatoen.
n
Number-objekt. Antall år som skal legges til datoen. Desimaltall behandles som heltall, avrundet nedover.
Returnerer
Den datoen som opprettes når det oppgitte antall år legges til startdatoen.
Eksempler
Det følgende eksempelet legger år til en bestemt dato:
Det følgende eksempelet legger 5 år til hver datoverdi i HireDate-feltet:
Denne funksjonen returnerer et tall fra 1 til 31 som representerer dagen i måneden for en gitt dato. Hvis datoen for eksempel er 2009-01-19, returnerer funksjonen 19.
Syntaks
Parameter
date
Datoobjekt. Et datoobjekt som dagen hentes fra.
Returnerer
Et heltall som representerer dagen i måneden for en gitt dato.
Eksempler
Det følgende eksempelet returnerer dagen i måneden for hver verdi i ShipDate-feltet:
Det følgende eksempelet returnerer dagen i måneden for den gjeldende datoen:
Denne funksjonen returnerer antall dager mellom to datoer. En dag beregnes ved å trekke dagverdien for den første datoen fra dagverdien for den andre datoen. Hvis den første datoen for eksempel er 2008-12-30 23:59:59, og den andre datoen er 2008-12-31 00:00:00, returnerer funksjonen 1 dag, selv om bare ett sekund skiller de to datoene.
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall dager mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall dager mellom bestemte datoer:
Det følgende eksempelet returnerer antall dager fra gjeldende dato til slutten av 2009:
Det følgende eksempelet returnerer antall dager mellom verdier i InvoiceDate- og PaymentDate-feltet:
Denne funksjonen returnerer antall timer mellom to datoer. En time beregnes ved å trekke timeverdien for den første datoen fra timeverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-31 1:30:00, og den andre datoen er 2009-01-31 2:00:00, returnerer funksjonen 1 time, selv om bare 30 minutter skiller de to datoene. Hvis en dato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall timer mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall timer mellom bestemte datoer:
Det følgende eksempelet returnerer antall timer fra gjeldende dato og klokkeslett til slutten av 2009:
Det følgende eksempelet returnerer antall timer mellom verdier i StartTime- og FinishTime-feltet:
Denne funksjonen returnerer antall minutter mellom to datoer. Et minutt beregnes ved å trekke minuttverdien for den første datoen fra minuttverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-31 1:30:59, og den andre datoen er 2009-01-31 1:31:00, returnerer funksjonen 1 minutt, selv om bare ett sekund skiller de to datoene. Hvis en dato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall minutter mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall minutter mellom bestemte datoer:
Det følgende eksempelet returnerer antall minutter fra gjeldende dato og klokkeslett til begynnelsen av 2010:
Det følgende eksempelet returnerer antall minutter mellom verdier i StartTime- og FinishTime-feltet:
Denne funksjonen returnerer antall måneder mellom to datoer. En måned beregnes ved å trekke månedsverdien for den første datoen fra månedsverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-31, og den andre datoen er 2009-02-01, returnerer funksjonen 1 måned, selv om bare en dag skiller de to datoene.
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall måneder mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall måneder mellom bestemte datoer:
Det følgende eksempelet returnerer antall måneder fra gjeldende dato til begynnelsen av 2010:
Det følgende eksempelet returnerer antall måneder mellom verdier i ProjectStart- og ProjectComplete-feltet:
Denne funksjonen returnerer antall kvartaler mellom to datoer. Et kvartal beregnes ved å trekke månedsverdien for den første datoen fra månedsverdien for den andre datoen. En differanse på 3 måneder er lik 1 kvartal. Hvis den første datoen for eksempel er 2009-01-31, og den andre datoen er 2009-07-01, returnerer funksjonen 2. Hvis den første datoen er 2009-01-01, og den andre datoen er 2009-09-30, returnerer funksjonen også 2.
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall kvartaler mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall kvartaler mellom bestemte datoer:
Det følgende eksempelet returnerer antall kvartaler fra gjeldende dato til begynnelsen av 2010:
Det følgende eksempelet returnerer antall kvartaler mellom verdier i ProjectStart- og ProjectComplete-feltet:
Denne funksjonen returnerer antall sekunder mellom to datoer. Hvis en dato ikke har en klokkeslettverdi, antar funksjonen at klokkeslettet er midnatt (00:00:00).
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall sekunder mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall sekunder mellom bestemte datoer:
Det følgende eksempelet returnerer antall sekunder fra gjeldende dato og klokkeslett til begynnelsen av 2010:
Det følgende eksempelet returnerer antall sekunder mellom verdier i StartTime- og FinishTime-feltet:
Denne funksjonen returnerer antall uker mellom to datoer. En uke beregnes ved å trekke ukeverdien for den første datoen fra ukeverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-02 (uke 1 i året), og den andre datoen er 2009-01-05 (uke 2 i året), returnerer funksjonen 1 uke, selv om bare tre dager skiller de to datoene.
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall uker mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall uker mellom bestemte datoer:
Det følgende eksempelet returnerer antall uker fra gjeldende dato til begynnelsen av 2010:
Det følgende eksempelet returnerer antall uker mellom verdier i ProjectStart- og ProjectComplete-feltet:
Denne funksjonen returnerer antall år mellom to datoer. Et år beregnes ved å trekke årsverdien for den første datoen fra årsverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-01, og den andre datoen er 2009-12-31, returnerer funksjonen 0. Hvis den første datoen er 2008-11-15, og den andre datoen er 2009-01-15, returnerer funksjonen 1.
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall år mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall år mellom bestemte datoer:
Det følgende eksempelet returnerer antall år mellom hver verdi i HireDate-feltet og den gjeldende datoen:
Denne funksjonen returnerer antall år mellom to datoer. Et år beregnes ved å trekke årsverdien for den første datoen fra årsverdien for den andre datoen. Hvis den første datoen for eksempel er 2009-01-01, og den andre datoen er 2009-12-31, returnerer funksjonen 0. Hvis den første datoen er 2008-11-15, og den andre datoen er 2009-01-15, returnerer funksjonen 1.
Syntaks
Parametere
date1
Et datoobjekt som representerer starten av tidsrommet.
date2
Et datoobjekt som representerer slutten av tidsrommet.
Returnerer
Heltall. Antall år mellom to datoer.
Eksempler
Det følgende eksempelet returnerer antall år mellom bestemte datoer:
Det følgende eksempelet returnerer antall år mellom hver verdi i HireDate-feltet og den gjeldende datoen:
Denne funksjonen returnerer datoen for den første dagen i måneden som oppgitt dato tilhører.
Syntaks
Parametere
date
Et datoobjekt som måneden hentes fra.
Returnerer
Datoobjekt. Den første dagen i måneden for en gitt dato.
Eksempler
Det følgende eksempelet viser månedsverdier som er returnert for en bestemt dato:
Denne funksjonen returnerer datoen for den første dagen i kvartalet som oppgitt dato tilhører.
Syntaks
Parametere
date
Et datoobjekt som kvartalet hentes fra.
Returnerer
Datoobjekt. Den første dagen i kvartalet for en gitt dato.
Eksempler
Det følgende eksempelet viser kvartalsverdier som er returnert for en bestemt dato:
Denne funksjonen returnerer datoen for den første dagen i uken som oppgitt dato tilhører.
Syntaks
Parametere
date
Et datoobjekt som uken hentes fra.
Returnerer
Datoobjekt. Den første dagen i uken for en gitt dato.
Eksempler
Det følgende eksempelet viser ukeverdier som er returnert for en bestemt dato:
Denne funksjonen returnerer datoen for den første dagen i året som oppgitt dato tilhører.
Syntaks
Parametere
date
Et datoobjekt som året hentes fra.
Returnerer
Datoobjekt. Den første dagen i året for en gitt dato.
Eksempler
Det følgende eksempelet viser årsverdier som er returnert for en bestemt dato:
Denne funksjonen returnerer måneden for en gitt dato. Avhengig av hvilket alternativ du oppgir, returnerer funksjonen måneden som månedsnummeret, det fullstendige månedsnavnet eller det forkortede månedsnavnet. Månedsnavnet er språkmiljøspesifikt.
Syntaks
Parametere
date
Et datoobjekt som måneden hentes fra.
option
Heltall. Valgfri. Et tall som representerer månedsformatet som skal returneres. Bruk en av de følgende verdiene:
Hvis du utelater dette argumentet, returnerer funksjonen måneden som et nummer.
Returnerer
Streng. Måneden for en gitt dato.
Eksempler
Det følgende eksempelet viser månedsverdier som er returnert for en bestemt dato:
Det følgende eksempelet returnerer måneden for den gjeldende datoen:
Denne funksjonen returnerer gjeldende dato og klokkeslett, for eksempel Feb 2, 2009 2:05 PM.
Syntaks
Returnerer
Datoobjekt. Gjeldende dato og klokkeslett.
Eksempel
Det følgende eksempelet returnerer hvor mange timer det er fra gjeldende dato og klokkeslett til jul:
Denne funksjonen returnerer et tall fra 1 til 4 som representerer kvartalet som en gitt dato tilhører. Første kvartal begynner 1. januar.
Syntaks
Parameter
date
Et datoobjekt som kvartalsnummeret hentes fra.
Returnerer
Heltall. Kvartalsnummeret for en gitt dato.
Eksempler
Det følgende eksempelet viser kvartalsnumrene som er returnert for bestemte datoer:
Det følgende eksempelet returnerer kvartalsnummeret for hver verdi i CloseDate-feltet:
Det følgende eksempelet returnerer kvartalsnummeret for den gjeldende datoen:
Denne funksjonen returnerer gjeldende dato, inkludert en klokkeslettverdi for midnatt, for eksempel Feb 2, 2009 12:00 AM.
Syntaks
Returnerer
Datoobjekt. Gjeldende dato med en klokkeslettverdi for midnatt.
Eksempler
Det følgende eksempelet returnerer antall dager fra gjeldende dato til jul:
Det følgende eksempelet beregner antall år fra hver verdi i HireDate-feltet til gjeldende dato.
Denne funksjonen returnerer et tall fra 1 til 52 som representerer ukenummeret for en gitt dato.
Syntaks
Parameter
date
Et datoobjekt som ukenummeret hentes fra.
Returnerer
Heltall. Ukenummeret for en gitt dato.
Eksempler
Det følgende eksempelet viser ukenumrene som er returnert for bestemte datoer:
Det følgende eksempelet returnerer ukenummeret for hver verdi i CloseDate-feltet:
Det følgende eksempelet returnerer ukenummeret for den gjeldende datoen:
Denne funksjonen returnerer ukedagen for en gitt dato. Avhengig av hvilket alternativ du oppgir, returnerer funksjonen ukedagen som et nummer, det fullstendige dagnavnet eller det forkortede dagnavnet. Navnet på ukedagen er språkmiljøspesifikt.
Syntaks
Parametere
date
Et datoobjekt som ukedagen hentes fra.
option
Heltall. Valgfri. Et tall som representerer formatet som skal returneres. Bruk en av de følgende verdiene:
Hvis du utelater dette argumentet, antar funksjonen alternativ 1.
Returnerer
Streng. Ukedagen for en gitt dato.
Eksempler
Det følgende eksempelet viser ukedagverdier som er returnert for en bestemt dato:
Det følgende eksempelet returnerer ukedagen for den gjeldende datoen:
Denne funksjonen returnerer den firesifrede årsverdien for en gitt dato. Hvis datoen for eksempel er 2009-01-19, returnerer funksjonen 2009.
Syntaks
Parameter
date
Et datoobjekt som året hentes fra.
Returnerer
Heltall. Den firesifrede verdien for en gitt dato.
Eksempler
Det følgende eksempelet returnerer året for hver verdi i HireDate-feltet:
Det følgende eksempelet returnerer året for den gjeldende datoen: