
Blok funkcji STR2DT przelicza dowolną datę podaną w formie tekstowej języka angielskiego na nową datę.
Na wejściu przekazywana jest data i czas w formacie DT#.
Definiuje ciąg znaków do obliczania daty.
Wejście może zdefiniować datę sprzed 1970. W tym celu należy przekazać format, taki jak "12/25/0000", co odpowiada pierwszemu Świętowi Bożego Narodzenia. Pierwsza liczba 12 oznacza miesiąc, a druga 25 dzień. Rok musi być wprowadzany czterocyfrowo, w przeciwnym razie przyjmowany jest tylko wartość roku 2000.
| Opis | Format |
|---|---|
| Nazwa dnia | 'sunday' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat' |
| Dni tygodnia | 'weekday' | 'weekdays' |
| Numer | [+-]?[0-9]+ |
| Porządkowe | 'first' | 'second' | 'third' | 'fourth' | 'fifth' | 'sixth' | 'seventh' | 'eighth' | 'ninth' | 'tenth' | 'eleventh' | 'twelfth' | 'next' | 'last' | 'previous' | 'this' |
| Teksty względne | 'next' | 'last' | 'previous' | 'this' |
| Spacje | [ \t]+ |
| Jednostki | (('sec' | 'second' | 'min' | 'minute' | 'hour' | 'day' | 'fortnight' | 'forthnight' | 'month' | 'year') 's'?) | 'weeks' | daytext |
| Format | Opis | Przykłady |
|---|---|---|
| 'yesterday' | Północ z wczorajszej nocy. | "yesterday 14:00" |
| 'midnight' | Czas ustawiany na 00:00:00 | |
| 'today' | Czas ustawiany na 00:00:00 | |
| 'now' | Ignorowany. | |
| 'noon' | Czas ustawiany na 12:00:00 | "yesterday noon" |
| 'tomorrow' | Północ z przyszłej nocy. | |
| 'back of' hour | 15 minut później od określonej godziny. | "back of 7pm", "back of 15" |
| 'front of' hour | 15 minut wcześniej od określonej godziny. | "front of 5am", "front of 23" |
| 'first day of' | Ustawia dzień na pierwszy dzień miesiąca bieżącego miesiąca. Działa również z podanym miesiącem i rokiem. | "first day of January 2008" |
| 'last day of' | Ustawia dzień na ostatni dzień miesiąca bieżącego miesiąca. Działa również z podanym miesiącem i rokiem. | "last day of next month" |
| ordinal space dayname space 'of' | Oblicza x-ty dzień tygodnia w miesiącu. | "first sat of July 2008" |
| 'last' space dayname space 'of' | Oblicza ostatni dzień tygodnia w miesiącu. | "last sat of July 2008" |
| number space? (unit | 'week') | Oblicza względny offset do bieżącej daty. | "+5 weeks", "12 day", "-7 weekdays" |
| ordinal space unit | Oblicza względny czas do podanej jednostki. | "fifth day", "second month" |
| 'ago' | Oblicza punkt w czasie wstecz. | "2 days ago", "8 days ago 14:00", "2 months 5 days ago", "2 months ago 5 days", "2 days ago" |
| dayname | Przechodzi do następnego dnia tygodnia. | "Monday" |
| reltext space 'week' | Oblicza specjalny format "weekday + last/this/next week". | "Monday next week" |
Zwraca obliczoną datę i czas w formacie DT#.
W przypadku błędu wyjście jest prawdziwe.