Poniżej przedstawiono przykłady wyrażeń raportów na potrzeby pytań typu date (data) i date-time (data i czas).
Notatka:
Te wyrażenia nie mają zastosowania do pytań typu time (czas), które są przechowywane jako ciągi znakowe.
Aby zapewnić, że pytania typu date (data) i date-time (data i czas) są prezentowane w sposób zgodny z formatowaniem stosowanym w używanych ustawieniach regionalnych, można użyć wyrażenia formatującego pytanie zgodnie z danymi ustawieniami regionalnymi. Metodę locale należy umieścić na początku wyrażenia, a kod ustawień regionalnych należy zapisać małymi literami:
${datetime | locale:"pt-br"}
Notatka:
Informacje o kodzie ustawień regionalnych dla określonego języka można znaleźć w temacie Wikipedii zatytułowanym List of ISO 639-1 codes (Lista kodów ISO 639-1). Jednak nie wszystkie te języki są obsługiwane w aplikacji Survey123.
Wszystkie wartości daty i czasu w warstwie obiektowej są przechowywane w formacie uniwersalnego czasu koordynowanego (UTC). Domyślnie wszystkie wartości daty i czasu zwracane w raporcie są w tej samej strefie czasowej co przeglądarka internetowa, która została użyta do żądania wygenerowania raportu. Metody utcOffset można używać do modyfikowania sposobu wyświetlania tych wartości w raporcie w taki sposób, aby był on zgodny z określoną strefą czasową. W poniższym przykładzie wyświetlana jest odpowiedź na pytanie typu date-time (data-czas), w przypadku której czas został przesunięty o jedną godzinę do przodu w stosunku do czasu UTC:
${datetime | utcOffset:"+01:00"}
Metoda utcOffset obsługuje formaty +01:00, +0100 i +01 oraz zwraca ten sam wynik. Tej metody można także używać do modyfikowania sposobu wyświetlania czasu wypełnienia odpowiedzi.
W przypadku pytań typu date (data) lub date-time (data-czas) można użyć wyrażenia do sformatowania daty za pomocą symboli zastępczych DD, MM i RRRR dla określenia formatu odpowiednio dnia, miesiąca i roku. Poniższe wyrażenie powoduje wyświetlenie tylko wartości dnia i miesiąca bez podawania roku:
${date | format:"DD/MM"}
W pytaniach typu date-time (data-czas) można również sformatować czas, używając symboli zastępczych GG, mm i ss odpowiednio dla godzin, minut i sekund. Poniższe wyrażenie powoduje wyświetlenie wartości dnia, miesiąca, godziny i minut:
${datetime | format:"DD/MM HH:mm"}
Daty i godziny można wyświetlać w formacie ISO 8601 jako RRRR-MM-DDTGG:mm:ss±GG:mm, pozostawiając pustą wartość w metodzie format, jak pokazano w następującym przykładzie:
${datetime | format:""}
Więcej informacji na temat formatów daty i godziny zawiera poniższa tabela.
Notatka:
Metodę format należy umieścić na końcu wyrażenia.
Datę i godzinę wygenerowania raportu można wydrukować za pomocą słowa kluczowego $date. Za pomocą metody format można wskazać, czy wydrukowana ma zostać data, godzina, czy obie te wartości. W następującym przykładzie data wygenerowania raportu (bez godziny) jest drukowana w domyślnym formacie daty używanych ustawień narodowych:
${$date}
Następujące wyrażenie powoduje wydrukowanie miesiąca, dnia, roku, godziny i minut reprezentujących datę i godzinę wygenerowania raportu:
${$date | format:"MM/DD/YYYY HH:mm"}
Następujące wyrażenie powoduje wydrukowanie godziny wygenerowania raportu (bez daty) w godzinach, minutach i sekundach w formacie czasu 12-godzinnego:
${$date | format:"h:mm:ss A"}
Słowo kluczowe $date obsługuje także metody utcOffset i locale. Metoda locale jest ignorowana, jeśli określone są jednocześnie słowa kluczowe format i locale.
Formaty daty i czasu
Poniższa tabela zawiera listę najczęściej używanych symboli zastępczych, których można używać w metodzie format do formatowania dat i czasu w zapytaniach typu date (data) i date-time (data i czas) w raporcie.
| Symbol zastępczy | Opis |
|---|---|
YY | Dwie ostatnie cyfry roku. Przykład: rok 2023 będzie reprezentowany jako 23. |
YYYY | Cztery cyfry roku. Przykład: rok 2023 będzie reprezentowany jako 2023. |
M | Numer miesiąca z przedziału od 1 do 12. Przykład: styczeń będzie reprezentowany jako 1. |
MM | Dwucyfrowy numer miesiąca. Przykład: styczeń będzie reprezentowany jako 01. |
MMM | Miesiąc przedstawiony za pomocą trzech liter. Przykład: styczeń będzie reprezentowany jako sty. |
MMMM | Miesiąc zapisany w całości. Przykład: styczeń będzie reprezentowany jako styczeń. |
D | Numer dnia z przedziału od 1 do 31. Przykład: pierwszy dzień miesiąca jest reprezentowany jako 1. |
DD | Dwucyfrowy numer dnia. Przykład: pierwszy dzień miesiąca jest reprezentowany jako 01. |
Do | Numer dnia zawierający przyrostki porządkowe. Przykład: pierwszy dzień miesiąca jest reprezentowany jako 1. (cyfra 1 i kropka). |
H | Numer godziny w czasie 24-godzinnym. Przykład: godzina 11 wieczorem będzie reprezentowana jako 23. |
HH | Dwucyfrowy numer godziny w czasie 24-godzinnym. Przykład: godzina 2 w nocy będzie reprezentowana jako 02. |
h | Numer godziny w czasie 12-godzinnym. Przykład: godzina 11 wieczorem będzie reprezentowana jako 11. |
hh | Dwucyfrowy numer godziny w czasie 12-godzinnym. Przykład: godzina 2 w nocy będzie reprezentowana jako 02. |
m | Numer minuty w zakresie od 0 do 59. Przykład: 8 minut będzie reprezentowane jako 8. |
mm | Dwucyfrowy numer minuty. Przykład: 8 minut będzie reprezentowane jako 08. |
ss | Dwucyfrowa liczba sekund. Przykład: 9 sekund będzie reprezentowane jako 09. |
Z | Przesunięcie strefy czasowej w godzinach przy użyciu separatora. Przykłady: -07:00, +13:00 |
ZZ | Przesunięcie strefy czasowej w godzinach bez separatora. Przykłady: -0700, +1300 |
x | Milisekundowy znacznik czasu systemu UNIX. Przykład: godzina 21:00 w dniu 4 maja 2023 r. czasu GMT będzie reprezentowana jako 1683234000000. |
X | Znacznik czasu systemu UNIX. Przykład: godzina 21:00 w dniu 4 maja 2023 r. czasu GMT będzie reprezentowana jako 1683234000. |
a | Oznaczenie poranka lub popołudnia małymi literami. Przykład: a.m. będzie reprezentowane jako am, a p.m. będzie reprezentowane jako pm. |
A | Oznaczenie poranka lub popołudnia wielkimi literami. Przykład: a.m. będzie reprezentowane jako AM, a p.m. będzie reprezentowane jako PM. |