Date
| Formát: | DATE [<den>] [<datum>] [<čas>] [SERVER <název>] [PORT <n>] [OFFSET <n>] [LFORMAT <řetězec>] [TO|VER <soubor>] |
| Šablona: | DAY, DATE, TIME, SERVER/K, PORT/K/N, OFFSET/K/N, LFORMAT/K, TO=VER/K |
| Účel: | Zobrazuje a nastavuje systémové datum a čas |
| Cesta: | C:DATE |
Příkaz DATE bez argumentů zobrazí aktuální systémové datum a čas, údaj obsahuje i jméno dne v týdnu. Čas se zobrazuje ve 24hodinovém formátu.
Parametry
| <datum> | Nastavuje nové datum. Datum se zadává ve formátu DD-MMM-RR (den-měsíc-rok). Mezi čísly musí být pomlčky. Pokud je den jednociferné číslo, stačí zadat toto číslo, úvodní nula nutná není. Měsíc se zadává prvními třemi písmeny anglického názvu měsíce (například pro leden to je Jan - anglicky se leden jmenuje January). Rok se zadává posledním dvojčíslím letopočtu. Datum nemůže být starší než 1. leden 1978, které systém používá jako výchozí bod kalendářních výpočtů. |
| <den> | Další možností je nastavit den. Můžete zadat anglické jméno dne, nebo také slova "yesterday" a "tomorrow" (včera a zítra). Tím posunete datum na příslušný den aktuálního týdne. |
| <čas> | Nastaví nový systémový čas. Čas se zadává ve formátu HH:MM:SS (hodiny:minuty:sekundy), sekundy zadávat nemusíte. |
| TO | Volba TO (nebo její ekvivalent VER) ve spojení se jménem souboru zapíše výstup příkazu DATE do zadaného souboru. Pokud již takový soubor existuje, bude přepsán. |
Řada Amig má hardwarové, baterií zálohované hodiny. Ty pracují i po vypnutí počítače a tak systémové datum a čas odpovídají skutečným hodnotám (když pomineme možné nepřesnosti) - po spuštění systému se načte údaj z hardwarových hodin. Jsou ovšem i Amigy bez hardwarových hodin (například základní Amigy 1200). U takových systémů se po spuštění nastaví datum na datum naposledy vytvořeného souboru na zaváděcí disketě nebo disku.
Příkaz DATE neovlivňuje hardwarové hodiny, mění jen hodiny softwarové. Chcete-li změnit nastavení hardwarových hodin, musíte použít příkaz SETCLOCK.
| SERVER | Tento argument se používá k načtení aktuálního data a času ze vzdáleného serveru prostřednictvím TCP/IP připojení pomocí protokolu NTP (Network Time Protocol). Seznam NTP časových serverů a některé další informace najdete na této adrese. Volba SERVER může být nastavena na speciální hodnotu „PREFS“, která načte datum a čas z aktuálně nakonfigurovaných informací o vzdáleném serveru uložených v časových preferencích. |
| PORT | Můžete zadat jiné číslo portu než je odlišné výchozí port 123. |
| LFORMAT | Upravuje výstup příkazu DATE pomocí jednoho nebo více operátorům které jsou rozepsány níže. |
Dostupné operátory pro volbu LFORMAT
| %a | Zkrácený název dne v týdnu |
| %A | Název dne v týdnu |
| %b | Zkrácený název měsíce |
| %B | Název měsíce |
| %c | Stejné jako "%a %b %d %H:%M:%S %Y" |
| %d | Číslo dne s úvodní nulou na začátku |
| %D | Stejné jako "%m/%d/%y" |
| %e | Číslo dne s úvodními mezerami |
| %h | Zkrácený název měsíce |
| %H | Hodina pomocí 24-hodinového stylu s úvodní nulou |
| %I | Hodina pomocí 12-hodinového stylu s úvodní nulou |
| %j | Juliánské datum |
| %m | Číslo měsíce s úvodní nulou |
| %M | Číslo minut s úvodní nulou |
| %n | Vloží řádek |
| %p | Řetězce AM nebo PM |
| %q | Hodina pomocí 24-hodinového stylu |
| %Q | Hodina pomocí 12-hodinového stylu |
| %r | Stejné jako "%I:%M:%S %p" |
| %R | Stejné jako "%H:%M" |
| %S | Číslo vteřin s úvodní nulou |
| %t | Vloží tabulátor |
| %T | Stejné jako "%H:%M:%S" |
| %U | Číslo týdne, přičemž neděle je první den v týdnu |
| %w | Číslo dne v týdnu |
| %W | Číslo týdne, přičemž pondělí je první den v týdnu |
| %x | Stejné jako "%m/%d/%y" |
| %X | Stejné jako "%H:%M:%S" |
| %y | Rok pomocí dvou číslic s úvodními nulami |
| %Y | Rok pomocí čtyř číslic s úvodními nulami |
Výsledek
Pokud příkaz DATE uspěl v nastavení systémového data nebo času, bude primární návratový kód (RC) nastaven na 0.
Návratový kód 5 nebo 20 znamená, že příkaz DATE částečně nebo úplně selhal. Pokud při pokusu o získání času ze vzdáleného serveru došlo k chybě, primární návratový kód bude nastaven na 21. V tomto případě může sekundární návratový kód (RESULT2) obsahovat číslo TCP chyby a zobrazí se odpovídající chybová zpráva.
Příklad
| 1> DATE |
Zobrazí aktuální datum a čas.
| 1> DATE LFORMAT "Today it's %A, %m/%d/%Y, %T" |
Zobrazí informaci ve formátu "Dnes je pondělí, 02/17/2003, 22:30:56".
| 1> DATE 1-jan-04 |
Nastaví datum na 1 ledna 2004 (nejnižší nastavitelné datum je 1 ledna 1978). Čas nebude nastaven.
| 1> DATE tomorrow |
Nastaví datum o jeden den dopředu.
| 1> DATE TO Fred |
Uloží aktuální datum do souboru Fred.
| 1> DATE 23:00 |
Nastaví aktuální čas na 23:00h.
| 1> DATE SERVER foo.bar.com OFFSET -480 |
Získá aktuální datum a čas z NTP serveru foo.bar.com umístěného na základě tichomořského standardního času používaného ve Spojených státech.
