Delphi - Új dátum/idő függvények a Delphi 6-ban

Dátum/idő függvények 3. rész

forráskód letöltése
Folytatjuk a dátum/idő függvények bemutatását a harmadik résszel. Ebben a részben azokat a függvényeket mutatjuk be, amelyek két adott dátum illetve időpont között eltelt különböző időegységek lekérdezését, illetve ellenőrzését teszik lehetővé. Ha például kíváncsiak vagyunk rá, hogy két dátum között hány perc telt el, vagy arra, hogy egy adott személy elmúlt-e már 18 éves, akkor ezeknek a függvényeknek a használatával egyszerűen megkaphatjuk a választ.
WithinPastYears
Osztály:
function WithinPastYears(
const ANow,
AThen: TDateTime;
const AYears: Integer
): Boolean;
A függvény ellenőrzi, hogy két dátum között eltelt-e adott számú év. Ha például azt akarjuk megtudni, hogy egy személy elmúlt-e már 18 éves, akkor megadjuk a születési dátumát, a jelenlegi dátumot, valamint a 18-at. Ha a függvény visszatérési értéke hamis, akkor az adott személy elmúlt 18 éves, ha igaz, akkor még nem múlt el 18 év a két dátum között.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const AYears: Integer
Évek száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi év, amennyit az AYears paraméterben megadtunk.
WithinPastMonths
Osztály:
function WithinPastMonths(
const ANow,
AThen: TDateTime;
constAMonths: Integer
): Boolean;
A függvény ellenőrzi, hogy két dátum között eltelt-e adott számú hónap.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const AMonths: Integer
Hónapok száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el az AMonths paraméterben megadott számú hónap.
WithinPastWeeks
Osztály:
function WithinPastWeeks(
const ANow,
AThen: TDateTime;
const AWeeks: Integer
): Boolean;
A függvény ellenőrzi, hogy két megadott dátum között eltelt-e adott számú hét.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const AWeeks: Integer
A hetek száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi hét, amennyit az AWeeks paraméterben megadtunk.
WithinPastDays
Osztály:
function WithinPastDays(
const ANow,
AThen: TDateTime;
const ADays: Integer
): Boolean;
A függvény ellenőrzi, hogy két megadott dátum között eltelt-e adott számú nap.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const ADays: Integer
A napok száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi nap, amennyit az ADays paraméterben megadtunk.
WithinPastHours
Osztály:
function WithinPastHours(
const ANow,
AThen: TDateTime;
const AHours: Int64
): Boolean;
Ellenőrzi, hogy a paraméterben megadott két dátum között eltelt-e adott számú óra.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const AHours: Int64
Órák száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi óra, amennyit az AHours paraméterben megadtunk.
WithinPastMinutes
Osztály:
function WithinPastMinutes(
const ANow,
AThen: TDateTime;
const AMinutes: Int64
): Boolean;
Ellenőrzi, hogy a paraméterben megadott két dátum között eltelt-e adott számú perc.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const AMinutes: Int64
Percek száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi perc, amennyit az AMinutes paraméterben megadtunk.
WithinPastSeconds
Osztály:
function WithinPastSeconds(
const ANow,
AThen: TDateTime;
const ASeconds: Int64
): Boolean;
Ellenőrzi, hogy a paraméterben megadott két dátum között eltelt-e adott számú másodperc.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const ASeconds: Int64
Másodpercek száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi másodperc, amennyit az ASeconds paraméterben megadtunk.
WithinPastMilliSeconds
Osztály:
function WithinPastMilliSeconds(
const ANow,
AThen: TDateTime;
const AMilliSeconds: Int64
): Boolean;
Ellenőrzi, hogy a paraméterben megadott két dátum között eltelt-e adott számú ezredmásodperc.
Paraméterek
const ANow
Az első összehasonlítandó dátum.
AThen: TDateTime
A második összehasonlítandó dátum.
const AMilliSeconds: Int64
Ezredmásodpercek száma.
Visszatérési érték
Igaz, ha a két dátum között még nem telt el annyi ezredmásodperc, amennyit az AMilliSeconds paraméterben megadtunk.
YearsBetween
Osztály:
function YearsBetween(
const ANow,
AThen: TDateTime
): Integer;
A függvény két dátum között eltelt évek számát adja vissza. Egész értékkel tér vissza, így csak a ténylegesen eltelt évek számítanak.
MonthsBetween
Osztály:
function MonthsBetween(
const ANow,
AThen: TDateTime
): Integer;
A paraméterben megadott két dátum között eltelt hónapok számával tér vissza.
WeeksBetween
Osztály:
function WeeksBetween(
const ANow,
AThen: TDateTime
): Integer;
Két adott dátum között eltelt hetek számát adja vissza.
DaysBetween
Osztály:
function DaysBetween(
const ANow,
AThen: TDateTime
): Integer;
Két dátum között eltelt napok számával tér vissza.
HoursBetween
Osztály:
function HoursBetween(
const ANow,
AThen: TDateTime
): Int64;
A paraméterben megadott két dátum között eltelt egész órák számával tér vissza.
MinutesBetween
Osztály:
function MinutesBetween(
const ANow,
AThen: TDateTime
): Int64;
A paraméterekben megadott két dátum között eltelt percek számát adja vissza.
SecondsBetween
Osztály:
function SecondsBetween(
const ANow,
AThen: TDateTime
): Int64;
A paraméterekben megadott két dátum között eltelt másodpercek számával tér vissza.
MilliSecondsBetween
Osztály:
function MilliSecondsBetween(
const ANow,
AThen: TDateTime
): Int64;
A két paraméterben megadott dátumok között eltelt ezredmásodpercek számával tér vissza.

Dátum/idő függvények cikksorozat