A BirtDateTime osztály két dátum
vagy időpont között eltelt idő mennyiségének megállapításához,
időtartományok összeadásához vagy kivonásához, valamint egy dátum
részeinek lekérdezéséhez biztosít függvényeket. Mivel az időtartamok csak
számok, ezért az alkalmazás szokásos matematikai műveleteket használ
ezekhez: szorzás, osztás, összeadás, kivonás, és így tovább. Ez az osztály statikus. Az alkalmazás nem hozhat létre példányokat az osztályból.
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú nap összeadásának eredménye. A hozzáadandó napok száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
Date objektum. A kezdődátumot képviselő dátum objektum.
n
Number objektum. A dátumhoz hozzáadandó
napok száma. A tizedes számokat egyész számként kezeli, a legközelebbi egész számra lefelé kerekítve.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú nap hozzáadásával létrejött dátum.
Példák
A következő példa napokat ad hozzá egy megadott dátumhoz:
A következő példa 15 napot ad hozzá az InvoiceDate (számla dátuma) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú óra összeadásának eredménye. A hozzáadandó órák száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
A kezdődátumot képviselő dátum objektum. Ha a kezdődátumban nincs időpont érték, akkor a függvény azt feltételezi, hogy az időpont az éjfél (00:00:00).
n
Number objektum. A dátumhoz hozzáadandó órák száma.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú óra hozzáadásával létrejött dátum.
Példák
A következő példa órákat ad hozzá egy megadott dátumhoz és időponthoz:
A következő példa 36 órát ad hozzá az StartTime (kezdési idő) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú perc összeadásának eredménye. A hozzáadandó percek száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
A kezdődátumot képviselő dátum objektum. Ha a kezdődátumban nincs időpont érték, akkor a függvény azt feltételezi, hogy az időpont az éjfél (00:00:00).
n
Number objektum. A dátumhoz hozzáadandó percek száma.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú perc hozzáadásával létrejött dátum.
Példák
A következő példa perceket ad hozzá egy megadott dátumhoz és időponthoz:
A következő példa 15 percet ad hozzá az StartTime (kezdési idő) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú hónap összeadásának eredménye. A hozzáadandó hónapok száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Ez a függvény mindig érvényes dátumot ad vissza. Ha szükséges, az eredményül kapott dátum nap része vissza lesz igazítva az eredményül kapott év eredményül kapott hónapjának utolsó napjára. Például ha 2008. január 31-éhez hozzáad 1 hónapot, akkor az addMonth( ) függvény 2008 február 29-ét adja vissza (2008 szökőév), nem 2008. február 31-ét.
Szintaxis
Paraméterek
date
Date objektum. A kezdődátumot képviselő dátum objektum.
n
Number objektum. A dátumhoz hozzáadandó
hónapok száma. A tizedes számokat egyész számként kezeli, lefelé kerekítve.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú hónap hozzáadásával létrejött dátum.
Példák
A következő példa hónapokat ad hozzá egy megadott dátumhoz:
A következő példa 10 hónapot ad hozzá az InvoiceDate (számla dátuma) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú negyedév összeadásának eredménye. Egy negyedév három hónappal egyenlő. Ha például 2 negyedévet ad hozzá 2008. szeptember 10-éhez, akkor a függvény a 2009. március 10 dátumot adja vissza. A hozzáadandó negyedévek száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
A kezdődátumot képviselő dátum objektum.
n
Number objektum. A dátumhoz hozzáadandó negyedévek száma.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú negyedév hozzáadásával létrejött dátum.
Példák
A következő példa negyedéveket ad hozzá egy megadott dátumhoz:
A következő példa 2 negyedévet ad hozzá a ForecastClosing (előrejelzés vége) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú másodperc összeadásának eredménye. A hozzáadandó másodpercek száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
A kezdődátumot képviselő dátum objektum. Ha a kezdődátumban nincs időpont érték, akkor a függvény azt feltételezi, hogy az időpont az éjfél (00:00:00).
n
Number objektum. A dátumhoz hozzáadandó másodpercek száma.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú másodperc hozzáadásával létrejött eredmény.
Példák
A következő példa másodperceket ad hozzá egy megadott dátumhoz és időponthoz:
A következő példa 6000 másodpercet ad hozzá a StartTime (kezdési idő) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú hét összeadásának eredménye. A hozzáadandó hetek száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
A kezdődátumot képviselő dátum objektum.
n
Number objektum. A dátumhoz hozzáadandó hetek száma.
Visszatérési érték
Date objektum. A kezdődátumhoz a megadott számú hét hozzáadásával létrejött dátum.
Példák
A következő példa heteket ad hozzá egy megadott dátumhoz:
A következő példa 2 hetet ad hozzá az InvoiceDate (számla dátuma) mező minden egyes dátum értékéhez:
Ez a függvény egy új dátumot ad vissza, amely a kezdődátum és a megadott számú év összeadásának eredménye. A hozzáadandó évek száma lehet negatív szám. Ebben az esetben az eredmény olyan, mintha a szám ki lenne vonva a dátumból.
Szintaxis
Paraméterek
date
A kezdődátumot képviselő dátum objektum.
n
Number objektum. A dátumhoz hozzáadandó évek száma. A tizedes számokat egyész számként kezeli, lefelé kerekítve.
Visszatérési érték
A kezdődátumhoz a megadott számú év hozzáadásával létrejött dátum.
Példák
A következő példa éveket ad hozzá egy megadott dátumhoz:
A következő példa 5 évet ad hozzá az HireDate (felvétel ideje) mező minden egyes dátum értékéhez:
Ez a függvény egy 1 és 31 közé eső számot ad vissza, amely a hónap napját képviseli egy adott dátumon belül. Például ha a dátum 2009-01-19, akkor a függvény a 19 értéket adja vissza.
Szintaxis
Paraméter
date
Date objektum. A dátum objektum, amelyből a napot le kell kérdezni.
Visszatérési érték
Egész szám, amely az adott dátumban lévő hónap napját képviseli.
Példák
A következő példa a ShipDate (szállítási dátum) mező egyes értékeiben lévő hónap napját adja vissza:
A következő példa az aktuális dátumban lévő hónap napját adja vissza:
Ez a függvény a két dátum közötti napok számát adja vissza. A nap kiszámítása úgy történik, hogy a függvény kivonja az első dátum nap értékét a második dátum nap értékéből. Például ha az első dátum 2008-12-30 23:59:59 és a második dátum 2008-12-31 00:00:00, akkor a függvény 1 napot ad vissza, még akkor is, ha csak egy másodperc választja el a két dátumot.
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti napok száma.
Példák
A következő példa két adott dátum közötti napok számát adja vissza:
A következő példa az aktuális dátumtól 2009 végéig terjedő időszak napjainak számát adja vissza:
A következő példa az InvoiceDate (számla dátuma) és a PaymentDate (fizetési dátum) mezők értékei között lévő napok számát adja vissza:
Ez a függvény a két dátum közötti órák számát adja vissza. Az órák kiszámítása úgy történik, hogy a függvény kivonja az első dátum óra értékét a második dátum óra értékéből. Például, ha az első dátum 2009-01-31 1:30:00 és a második dátum 2009-01-31 2:00:00, akkor a függvény 1 órát ad vissza, még akkor is, ha a két dátumot csak 30 perc választja el egymástól. Ha a dátumban nincs időpont érték, akkor a függvény azt feltételezi, hogy az időpont éjfél (00:00:00).
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti órák száma.
Példák
A következő példa két adott dátum közötti órák számát adja vissza:
A következő példa az aktuális dátum és 2009 vége közötti időszak óráinak számát adja vissza:
A következő példa a StartTime (kezdési idő) és a FinishTime (befejezési idő) mezők értékei között lévő órák számát adja vissza:
Ez a függvény két dátum közötti percek számát adja vissza. A percek kiszámítása úgy történik, hogy a függvény kivonja az első dátum perc értékét a második dátum perc értékéből. Például, ha az első dátum 2009-01-31 1:30:59 és a második dátum 2009-01-31 1:31:00, akkor a függvény 1 percet ad vissza, még akkor is, ha a két dátumot csak 1 másodperc választja el egymástól. Ha a dátumban nincs időpont érték, akkor a függvény azt feltételezi, hogy az időpont éjfél (00:00:00).
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti percek száma.
Példák
A következő példa két adott dátum közötti percek számát adja vissza:
A következő példa az aktuális dátum és 2010 kezdete közötti időszak perceinek számát adja vissza:
A következő példa a StartTime (kezdési idő) és a FinishTime (befejezési idő) mezők értékei között lévő percek számát adja vissza:
Ez a függvény a két dátum között eltelt hónapok számát adja vissza. A hónapok kiszámítása úgy történik, hogy a függvény kivonja az első dátum hónap értékét a második dátum hónap értékéből. Például, ha az első dátum 2009-01-31 és a második dátum 2009-02-01, akkor a függvény 1 hónapot ad vissza, még akkor is, ha a két dátumot csak 1 nap választja el egymástól.
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti hónapok száma.
Példák
A következő példa két adott dátum közötti hónapok számát adja vissza:
A következő példa az aktuális dátumtól 2010 kezdetéig terjedő időszak hónapjainak számát adja vissza:
A következő példa a ProjectStart (projekt kezdete) és a ProjectComplete (projekt kész) mezők értékei között lévő hónapok számát adja vissza:
Ez a függvény a két dátum közötti negyedévek számát adja vissza. A negyedévek kiszámítása úgy történik, hogy a függvény kivonja az első dátum hónap értékét a második dátum hónap értékéből. Egy 3 hónapos különbség egyenlő 1 negyedévvel. Például, ha az első dátum 2009-01-31 és a második dátum 2009-07-01, akkor a függvény a 2 értéket adja vissza. Ha az első dátum 2009-01-01 és a második dátum 2009-09-30, akkor a függvény ugyancsak a 2 értéket adja vissza.
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti negyedévek száma.
Példák
A következő példa két adott dátum közötti negyedévek számát adja vissza:
A következő példa az aktuális dátumtól 2010 kezdetéig terjedő időszak negyedéveinek számát adja vissza:
A következő példa a ProjectStart (projekt kezdete) és a ProjectComplete (projekt kész) mezők értékei között lévő negyedévek számát adja vissza:
Ez a függvény a két dátum között eltelt másodpercek számát adja vissza. Ha a dátumban nincs időpont érték, akkor a függvény azt feltételezi, hogy az időpont éjfél (00:00:00).
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti másodpercek száma.
Példák
A következő példa két adott dátum közötti másodpercek számát adja vissza:
A következő példa az aktuális dátum és 2010 kezdete közötti időszak másodperceinek számát adja vissza:
A következő példa a StartTime (kezdési idő) és a FinishTime (befejezési idő) mezők értékei között lévő másodpercek számát adja vissza:
Ez a függvény a két dátum közötti hetek számát adja vissza. A hetek kiszámítása úgy történik, hogy a függvény kivonja az első dátum hét számáta második dátum hét számából. Például, ha az első dátum 2009-01-02 (az év első hete) és a második dátum 2009-01-05 (az év második hete), akkor a függvény 1 hetet ad vissza, még akkor is, ha a két dátumot csak három nap választja el egymástól.
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti hetek száma.
Példák
A következő példa két adott dátum közötti hetek számát adja vissza:
A következő példa az aktuális dátumtól 2010 kezdetéig terjedő időszak heteinek számát adja vissza:
A következő példa a ProjectStart (projekt kezdete) és a ProjectComplete (projekt kész) mezők értékei között lévő hetek számát adja vissza:
Ez a függvény a két dátum közötti évek számát adja vissza. Az évek kiszámítása úgy történik, hogy a függvény kivonja az első dátum év értékét a második dátum év értékéből. Például, ha az első dátum 2009-01-01 és a második dátum 2009-12-31, akkor a függvény a 0 értéket adja vissza. Ha az első dátum 2008-11-15 és a második dátum 2009-01-15, akkor a függvény az 1 értéket adja vissza.
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti évek száma.
Példák
A következő példa két adott dátum közötti évek számát adja vissza:
A következő példa a HireDate (felvételi dátum) egyes mezőinek értéke és az aktuális dátum közötti évek számát adja vissza:
Ez a függvény a két dátum közötti évek számát adja vissza. Az évek kiszámítása úgy történik, hogy a függvény kivonja az első dátum év értékét a második dátum év értékéből. Például, ha az első dátum 2009-01-01 és a második dátum 2009-12-31, akkor a függvény a 0 értéket adja vissza. Ha az első dátum 2008-11-15 és a második dátum 2009-01-15, akkor a függvény az 1 értéket adja vissza.
Szintaxis
Paraméterek
date1
Az időtartomány kezdetét képviselő dátum objektum.
date2
Az időtartomány végét képviselő dátum objektum.
Visszatérési érték
Egész szám. A két dátum közötti évek száma.
Példák
A következő példa két adott dátum közötti évek számát adja vissza:
A következő példa a HireDate (felvételi dátum) egyes mezőinek értéke és az aktuális dátum közötti évek számát adja vissza:
Ez a függvény annak a hónapnak az első napját adja vissza, amelyben a bemenetként megadott dátum található.
Szintaxis
Paraméterek
date
A dátum objektum, amelyből a hónapot le kell kérdezni.
Visszatérési érték
Date objektum. A hónap első napja egy adott dátumhoz.
Példák
A következő példa egy adott dátum visszaadott hónap értékére mutat be példát:
Ez a függvény annak a negyedévnek az első napját adja vissza, amelyben a bemenetként megadott dátum található.
Szintaxis
Paraméterek
date
A dátum objektum, amelyből a negyedévet le kell kérdezni.
Visszatérési érték
Date objektum. A negyedév első napja egy adott dátumhoz.
Példák
A következő példa egy adott dátum visszaadott negyedév értékére mutat be példát:
Ez a függvény annak a hétnek az első napját adja vissza, amelyben a bemenetként megadott dátum található. Ez mindig vasárnap.
Szintaxis
Paraméterek
date
A dátum objektum, amelyből a hetet le kell kérdezni.
Visszatérési érték
Date objektum. A hét első napja egy adott dátumhoz.
Példák
A következő példa egy adott dátum visszaadott hét értékére mutat be példát:
Ez a függvény annak az évnek az első napját adja vissza, amelyben a bemenetként megadott dátum található.
Szintaxis
Paraméterek
date
A dátum objektum, amelyből az évet le kell kérdezni.
Visszatérési érték
Date objektum. Az év első napja egy adott dátumhoz.
Példák
A következő példa egy adott dátum visszaadott év értékére mutat be példát:
Ez a függvény egy adott dátum hónap értékét adja vissza. A megadott beállítástól függően a függvény a hónapot számként, teljes hónapnévként vagy a hónap rövidített neveként adja vissza. A hónapnév a területi beállítást követi.
Szintaxis
Paraméterek
date
A dátum objektum, amelyből a hónapot le kell kérdezni.
option
Egész szám. Elhagyható. A visszaadandó hónap formátumát képviselő szám. Használja a következő értékek egyikét:
Ha kihagyja ezt az argumentumot, a függvény a hónapot számként adja vissza.
Visszatérési érték
Karaktersorozat. Egy adott dátum hónap értéke.
Példák
A következő példa egy adott dátum visszaadott hónap értékére mutat be példát:
A következő példa az aktuális dátum hónap értéket adja vissza:
A függvény az aktuális dátumot és időpontot adja vissza, például 2009. feb 2, DU 2:05.
Szintaxis
Visszatérési érték
Date objektum. Az aktuális dátum és idő.
Példa
A következő példa az aktuális dátum és karácsony közötti időszak óráinak számát adja vissza:
Ez a függvény egy 1 és 4 közé eső számot ad vissza, amely azt a negyedévet képviseli, amelyben egy adott dátumon található. Az első negyedév január 1-én kezdődik.
Szintaxis
Paraméter
date
A dátum objektum, amelyből a negyedévet le kell kérdezni.
Visszatérési érték
Egész szám. Egy adott dátum negyedév száma.
Példák
A következő példa az adott dátumokhoz visszaadott negyedév számának értékeit mutatja be:
A következő példa a CloseDate (lezárási dátum) mezőben lévő egyes értékekhez tartozó negyedév számát adja vissza.
A következő példa az aktuális dátum negyedév számát adja vissza:
A függvény az aktuális dátumot adja vissza éjfél időértékkel, például 2009. február 2. de. 12:00.
Szintaxis
Visszatérési érték
Date objektum. Az aktuális dátum az éjféli idő értékkel.
Példák
A következő példa az aktuális dátumtól karácsonyig terjedő időszak napjainak számát adja vissza:
A következő példa a HireDate (felvételi dátum) adatmező egyes mezőinek értéke és az aktuális dátum közötti évek számát számítja ki:
Ez a függvény egy 1 és 52 közé eső számot ad vissza, amely a hét számát képviseli egy adott dátumon belül.
Szintaxis
Paraméter
date
A dátum objektum, amelyből a hetet le kell kérdezni.
Visszatérési érték
Egész szám. Egy adott dátum hét száma.
Példák
A következő példa az adott dátumokhoz visszaadott hét számának értékeit mutatja be:
A következő példa a CloseDate (lezárási dátum) mező egyes értékeiben lévő hét számát adja vissza:
A következő példa az aktuális dátum hét számának értékét adja vissza:
Ez a függvény egy adott dátumhoz a hét napját adja vissza. A megadott beállítástól függően a függvény a hét napját számként, a hét napjának teljes nevével vagy rövidített nevével adja vissza. A hét napjainak nevei a területi beállítást követik.
Szintaxis
Paraméterek
date
A dátum objektum, amelyből a hét napját le kell kérdezni.
option
Egész szám. Elhagyható. A visszaadandó formátumot képviselő szám. Használja a következő értékek egyikét:
Ha kihagyja ezt az argumentumot, a függvény az 1 paramétert feltételezi.
Visszatérési érték
Karaktersorozat. A hét napja egy adott dátumhoz.
Példák
A következő példa az adott dátumhoz visszaadott hét napjának értékét mutatja be:
A következő példa a hét napját adja vissza az aktuális dátumhoz:
Ez a függvény egy négyjegyű számként adja vissza az év értékét az adott dátumhoz. Például, ha a dátum 2009-01-19, akkor a függvény a 2009 értéket adja vissza.
Szintaxis
Paraméter
date
A dátum objektum, amelyből az évet le kell kérdezni.
Visszatérési érték
Egész szám. A négyjegyű év érték egy adott dátumhoz.
Példák
A következő példa a HireDate (felvétel dátuma) mező egyes értékeihez tartozó év értéket adja vissza:
A következő példa az aktuális dátumhoz tartozó év értéket adja vissza: