Třída: ctDateTime

Třída ctDateTime komplexně implementuje datový typ datum a čas. Pracuje s gregoriánskám kalendářem. Podporuje operace jako přičítání a odečítání času, zjišťování rozdílu mezi dvěma datumy, formátování, testování správnosti datumu zadaného jako textový řetězec apod.

Konstruktory

public ctDateTime()

vytvoří objekt a s aktuálním datem a časem

public ctDateTime(ctDateTime source )

vytvoří objekt a s kopií zadaného data-času datem a časem

public ctDateTime( String sDate )

vytvoří objekt a nastaví datum a čas podle řetězce ve formátu dd.MM.yyyy[ hh:mm:ss ]

Členské metoda třídy

public void setString( String sDate )

tato metoda nastaví datum a čas podle řetězce ve formátu dd.MM.yyyy[ hh:mm:ss ].

public String getString()

tato metoda vrací datum a čas jako řetězec řetězce ve formátu dd.MM.yyyy[ hh:mm:ss ]. Časová složka je vypsána pouze pokud je nenulová.

public String getDateTimeString()

tato metoda vrací datum a čas jako řetězec řetězce ve formátu dd.MM.yyyy hh:mm:ss. Plný formát je použit i v případě, že čas je nulový.

public String getShortDateTimeString()

tato metoda vrací datum a čas jako řetězec řetězce ve formátu dd.MM.yyyy hh:mm. Plný formát je použit i v případě, že čas je nulový.

public String getDateString()

tato metoda vrací pouze datum jako řetězec ve formátu dd.MM.yyyy.

public String getTimeString()

tato metoda vrací pouze čas jako řetězec ve formátu hh:mm:ss.

public String getShortTimeString()

tato metoda vrací pouze čas jako řetězec ve formátu hh:mm.

public ctDateTime addDays( long days )

tato metoda nastaví nové datum jako datum uložené v objektu plus days dní. Vrací odkaz na referenční objekt.

public ctDateTime addTime( int hours, int minutes, int seconds )

tato metoda nastaví nové datum jako datum uložené v objektu plus čas zadaný parametry. Vrací odkaz na referenční objekt.

public long daysBefore( ctDateTime d )

tato metoda vrátí rozdíl zadaného datumu a datumu uloženého v objektu jako počet dní.

public ctDateTime clearTime()

tato metoda vyprázdní časovou složku datumu.

public boolean ok()

tato metoda vrací false, pokud poslední nastavované datum bylo neplatné ( chybný den, měsíc anebo rok ).

public int year()

tato metoda vrací rok z datumu uloženého v objektu.

public int month()

tato metoda vrací měsíc z datumu uloženého v objektu.

public int day()

tato metoda vrací den z datumu uloženého v objektu.

public int hour()

tato metoda vrací hodinu z datumu uloženého v objektu.

public int minute()

tato metoda vrací minutu z datumu uloženého v objektu.

public int second()

tato metoda vrací sekundu z datumu uloženého v objektu.

public int millisecond()

tato metoda vrací milisekundu z datumu uloženého v objektu.

public int weekDay()

tato metoda vrací den v týdnu z datumu uloženého v objektu ( nulou počínaje ).

Statické metody

Statické metoda lze v Javě volat přímo, tj. bez nutnosti deklarovat proměnné určité třídy. Syntaxe volání je <název třídy>.<název statické metody>(), např. ctDateTime myDate = ctDateTime.today() ;

public static ctDateTime today()

tato metoda vytvoří a vrátí aktuální datum.

public static ctDateTime now()

tato metoda vytvoří a vrátí aktuální datum a čas.

public static String todayStr()

tato metoda vrací aktuální datum jako formátovaný řetězec.

public static String nowStr()

tato metoda vrací aktuální datum a čas jako formátovaný řetězec.

public static String num2zs( int value )

tato metoda vrací kladné číslo převedené na řetězec. Je-li hodnota menší než 10, funkce doplní úvodní nulu.