mirror of
https://github.com/qgis/QGIS.git
synced 2025-02-25 00:58:06 -05:00
174 lines
3.8 KiB
Plaintext
174 lines
3.8 KiB
Plaintext
<h3>format_date() function</h3>
|
|
Format a date type or string into a custom string format. Uses Qt data time format strings. See <a href='http://qt-project.org/doc/qt-4.8/qdatetime.html#toString'>QDateTime::toString</a>
|
|
|
|
<h4>Syntax</h4>
|
|
<code>format_date('string', 'format_string')</code><br>
|
|
|
|
<h4>Arguments</h4>
|
|
<code>string</code> - is string. Date/Time/DateTime string.
|
|
<br>
|
|
<code>format_string</code> - is string. String template used to format the string.
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Expression</th>
|
|
|
|
<th>Output</th>
|
|
</tr>
|
|
</thead>
|
|
|
|
<tr valign="top">
|
|
<td>d</td>
|
|
|
|
<td>the day as number without a leading zero (1 to 31)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>dd</td>
|
|
|
|
<td>the day as number with a leading zero (01 to 31)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>ddd</td>
|
|
|
|
<td>the abbreviated localized day name (e.g. 'Mon' to 'Sun'). Uses <a href=
|
|
"qdate.html#shortDayName">QDate::shortDayName</a>().</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>dddd</td>
|
|
|
|
<td>the long localized day name (e.g. 'Monday' to 'Sunday'). Uses <a href=
|
|
"qdate.html#longDayName">QDate::longDayName</a>().</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>M</td>
|
|
|
|
<td>the month as number without a leading zero (1-12)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>MM</td>
|
|
|
|
<td>the month as number with a leading zero (01-12)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>MMM</td>
|
|
|
|
<td>the abbreviated localized month name (e.g. 'Jan' to 'Dec'). Uses <a href=
|
|
"qdate.html#shortMonthName">QDate::shortMonthName</a>().</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>MMMM</td>
|
|
|
|
<td>the long localized month name (e.g. 'January' to 'December'). Uses <a href=
|
|
"qdate.html#longMonthName">QDate::longMonthName</a>().</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>yy</td>
|
|
|
|
<td>the year as two digit number (00-99)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>yyyy</td>
|
|
|
|
<td>the year as four digit number</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<p>These expressions may be used for the time part of the format string:</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Expression</th>
|
|
|
|
<th>Output</th>
|
|
</tr>
|
|
</thead>
|
|
|
|
<tr valign="top">
|
|
<td>h</td>
|
|
|
|
<td>the hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>hh</td>
|
|
|
|
<td>the hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>H</td>
|
|
|
|
<td>the hour without a leading zero (0 to 23, even with AM/PM display)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>HH</td>
|
|
|
|
<td>the hour with a leading zero (00 to 23, even with AM/PM display)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>m</td>
|
|
|
|
<td>the minute without a leading zero (0 to 59)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>mm</td>
|
|
|
|
<td>the minute with a leading zero (00 to 59)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>s</td>
|
|
|
|
<td>the second without a leading zero (0 to 59)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>ss</td>
|
|
|
|
<td>the second with a leading zero (00 to 59)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>z</td>
|
|
|
|
<td>the milliseconds without leading zeroes (0 to 999)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>zzz</td>
|
|
|
|
<td>the milliseconds with leading zeroes (000 to 999)</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>AP or A</td>
|
|
|
|
<td>interpret as an AM/PM time. <i>AP</i> must be either "AM" or "PM".</td>
|
|
</tr>
|
|
|
|
<tr valign="top">
|
|
<td>ap or a</td>
|
|
|
|
<td>Interpret as an AM/PM time. <i>ap</i> must be either "am" or "pm".</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<br>
|
|
|
|
<h4>Example</h4>
|
|
<!-- Show example of function.-->
|
|
<code>format_date('2012-05-15','dd.mm.yyyy') → 15.00.2012</code><br> |