xref: /webtrees/resources/views/help/date.phtml (revision ac71572d8462e396ed5a307f05b29381e49f9e6e)
1<?php
2
3declare(strict_types=1);
4
5use Fisharebest\Webtrees\I18N;
6
7/**
8 * @var array<string,string> $date_dates
9 * @var array<string,string> $date_period_dates
10 * @var array<string,string> $date_period_shortcuts
11 * @var array<string,string> $date_range_dates
12 * @var array<string,string> $date_range_shortcuts
13 * @var array<string,string> $date_shortcuts
14 * @var array<string,string> $french_dates
15 * @var array<string,string> $hijri_dates
16 * @var array<string,string> $jalali_dates
17 * @var array<string,string> $jewish_dates
18 * @var array<string,string> $julian_dates
19 */
20
21?>
22
23<p>
24    <?= I18N::translate('Dates are stored using English abbreviations and keywords. Shortcuts are available as alternatives to these abbreviations and keywords.') ?>
25</p>
26
27<table class="table table-bordered table-sm">
28    <thead>
29        <tr>
30            <th>
31                <?= I18N::translate('Date') ?>
32            </th>
33            <th>
34                <?= I18N::translate('Format') ?>
35            </th>
36            <th>
37                <?= I18N::translate('Shortcut') ?>
38            </th>
39        </tr>
40    </thead>
41    <tbody>
42        <?php foreach ($date_dates as $code => $date) : ?>
43            <tr>
44                <td>
45                    <?= $date ?>
46                </td>
47                <td>
48                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
49                </td>
50                <td>
51                    <?php foreach ($date_shortcuts[$code] as $shortcut) : ?>
52                        <kbd dir="ltr" lang="en"><?= $shortcut ?></kbd>
53                        <br>
54                    <?php endforeach ?>
55                </td>
56            </tr>
57        <?php endforeach ?>
58    </tbody>
59</table>
60
61<p>
62    <?= I18N::translate('Date ranges are used to indicate that an event, such as a birth, happened on an unknown date within a possible range.') ?>
63</p>
64
65<table class="table table-bordered table-sm">
66    <thead>
67        <tr>
68            <th>
69                <?= I18N::translate('Date range') ?>
70            </th>
71            <th>
72                <?= I18N::translate('Format') ?>
73            </th>
74            <th>
75                <?= I18N::translate('Shortcut') ?>
76            </th>
77        </tr>
78    </thead>
79    <tbody>
80        <?php foreach ($date_range_dates as $code => $date) : ?>
81            <tr>
82                <td>
83                    <?= $date ?>
84                </td>
85                <td>
86                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
87                </td>
88                <td>
89                    <?php foreach ($date_range_shortcuts[$code] as $shortcut) : ?>
90                        <kbd dir="ltr" lang="en"><?= $shortcut ?></kbd>
91                        <br>
92                    <?php endforeach ?>
93                </td>
94            </tr>
95        <?php endforeach ?>
96    </tbody>
97</table>
98
99<p>
100    <?=I18N::translate('Date periods are used to indicate that a fact, such as an occupation, continued for a period of time.') ?>
101</p>
102
103<table class="table table-bordered table-sm">
104    <thead>
105        <tr>
106            <th>
107                <?= I18N::translate('Date period') ?>
108            </th>
109            <th>
110                <?= I18N::translate('Format') ?>
111            </th>
112            <th>
113                <?= I18N::translate('Shortcut') ?>
114            </th>
115        </tr>
116    </thead>
117    <tbody>
118        <?php foreach ($date_period_dates as $code => $date) : ?>
119            <tr>
120                <td>
121                    <?= $date ?>
122                </td>
123                <td>
124                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
125                </td>
126                <td>
127                    <?php foreach ($date_period_shortcuts[$code] as $shortcut) : ?>
128                        <kbd dir="ltr" lang="en"><?= $shortcut ?></kbd>
129                        <br>
130                    <?php endforeach ?>
131                </td>
132            </tr>
133        <?php endforeach ?>
134    </tbody>
135</table>
136
137<p>
138    <?= I18N::translate('Simple dates are assumed to be in the gregorian calendar. To specify a date in another calendar, add a keyword before the date. This keyword is optional if the month or year format make the date unambiguous.') ?>
139</p>
140
141<table class="table table-bordered table-sm">
142    <thead>
143        <tr>
144            <th>
145                <?= I18N::translate('Date') ?>
146            </th>
147            <th>
148                <?= I18N::translate('Format') ?>
149            </th>
150        </tr>
151    </thead>
152    <tbody>
153        <tr>
154            <th colspan="2">
155                <?= I18N::translate('Julian') ?>
156            </th>
157        </tr>
158        <?php foreach ($julian_dates as $code => $date) : ?>
159            <tr>
160                <td>
161                    <?= $date ?>
162                </td>
163                <td>
164                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
165                </td>
166            </tr>
167        <?php endforeach ?>
168
169        <tr>
170            <th colspan="2">
171                <?= I18N::translate('Jewish') ?>
172            </th>
173        </tr>
174        <?php foreach ($jewish_dates as $code => $date) : ?>
175            <tr>
176                <td>
177                    <?= $date ?>
178                </td>
179                <td>
180                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
181                </td>
182            </tr>
183        <?php endforeach ?>
184
185        <tr>
186            <th colspan="2">
187                <?= I18N::translate('Hijri') ?>
188            </th>
189        </tr>
190        <?php foreach ($hijri_dates as $code => $date) : ?>
191            <tr>
192                <td>
193                    <?= $date ?>
194                </td>
195                <td>
196                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
197                </td>
198            </tr>
199        <?php endforeach ?>
200
201        <tr>
202            <th colspan="2">
203                <?= I18N::translate('Jalali') ?>
204            </th>
205        </tr>
206        <?php foreach ($jalali_dates as $code => $date) : ?>
207            <tr>
208                <td>
209                    <?= $date ?>
210                </td>
211                <td>
212                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
213                </td>
214            </tr>
215        <?php endforeach ?>
216
217        <tr>
218            <th colspan="2">
219                <?= I18N::translate('French') ?>
220            </th>
221        </tr>
222        <?php foreach ($french_dates as $code => $date) : ?>
223            <tr>
224                <td>
225                    <?= $date ?>
226                </td>
227                <td>
228                    <kbd dir="ltr" lang="en"><?= $code ?></kbd>
229                </td>
230            </tr>
231        <?php endforeach ?>
232    </tbody>
233</table>
234