Pang-bô͘:Time ago/doc
 |
Che sī chi̍t phiⁿ soat-bêng chhù-ia̍h, sī ūi Pang-bô͘:Time ago siá--ê. Chia ū hâm sú-iōng chu-sìn, lūi-pia̍t kap kî-tha bô sio̍k goân-pún pang-bô͘ ia̍h ê chi̍t pō͘-hūn. |
 |
Pún pang-bô͘ hông sú-iōng tī approximately 120,000 ia̍h téng-bīn, só͘-í i-ê kái-piàn ē siū tio̍h tōa hoān-ûi ê chù-ì. Chhiáⁿ tī kài-piàn chìn-chêng seng tī pâng-bô͘ ê /sandbox ia̍h /testcases chhù-ia̍h-bīn chhì-giām, he̍k-chiá sī tī lí ka-tī ê iōng-chiá chhù-ia̍h-bīn. Chhiáⁿ tī si̍t-hêng kái-piàn chìn-cheng khó-lū seng tī thó͘-lūn-ia̍h chham-siông chi̍t--leh. |
 | Sú-iōng Lua thêng-sek: |
The Time ago template calculates the amount of time which has passed since a provided timestamp. The result is a string similar to one of the examples below. This template should not be used with "subst" unless you don't want the stamp to change as the user refreshes the page.
Note that due to Wikipedia's caching mechanisms, you may need to purge a page using this template to update the dynamic value. See the section Purge below.
The result is rounded down. "Month" is defined as 31 days.
Usage
siu-kái{{Time ago|timestamp}}
The timestamp can be almost any solid, readable format but to avoid ambiguity mistakes, one of the styles below is preferred.
magnitudeparameter can be set to explicitly use certain unit. Allowed values are:seconds,minutes,hours,days,weeks,monthsandyears.min_magnitudeparameter can be set to use the specified unit or bigger units. Allowed values are:seconds,minutes,hours,days,monthsandyears.agoparameter can be set to override the default usage of the text "ago". If the parameter is blank but not missing (i.e.{{time ago|2008|ago=}}), then the text "ago" is suppressed altogether. For future dates, setting "ago" as blank but not missing will suppress the text "time" (i.e. "2 years" instead of "2 years' time").
Spelling out numbers
siu-káiNumbers from 1 to 100 can be spelled out in their equivalent English word by using the spellout parameter. If spellout is set to "yes", "y", "true" or "1", all numbers from 1 to 100 will be spelled out. If spellout is set to "auto", only numbers from 1 to 9 will be spelled out, as per the recommendations at .
It is also possible to set a custom maximum value for spelling out by using the spelloutmax parameter. For example, setting |spellout=yes and |spelloutmax=24 will result in all numbers less than or equal to 24 being spelled out, and all numbers greater than 24 appearing as numerals.
Numeric output
siu-káiAdd |numeric=y to print the number only (no text).
Purge link
siu-káiAdd the parameter |purge=yes to add a purge link.
Examples
siu-kái{{Time ago| -83 minutes}}→ 83 hūn-cheng í-chêng{{Time ago| -334 minutes}}→ 5 tiám-cheng í-chêng{{Time ago| +334 minutes}}→ 5 tiám-cheng í-chêng{{Time ago|{{REVISIONTIMESTAMP}}}}→ 2 nî í-chêng{{Time ago| Jan 21, 2001 3:45 PM}}→ 23 nî í-chêng- Wrong:
{{Time ago| 3:45 pm, 21 Jan 2001}}→ í-chêng {{Time ago|20010121154500}}→ 23 nî í-chêng{{Time ago| Nov 6 2008}}→ 15 nî í-chêng{{Time ago| Nov 6 2008|magnitude=weeks}}→ 15 nî í-chêng{{Time ago| Nov 6 2008|min_magnitude=days}}→ 15 nî í-chêng{{Time ago| Nov 6 2008|min_magnitude=years}}→ 15 nî í-chêng{{Time ago| Nov 6 2008|ago=in the past}}→ 15 nî í-chêng{{Time ago| Nov 6 2008|purge=yes}}→ 15 nî í-chêng{{Time ago| 2008-11-06}}→ 15 nî í-chêng{{Time ago| June 1, 2009|spellout=yes}}→ 15 nî í-chêng{{Time ago| June 1, 1999|spellout=yes}}→ 25 nî í-chêng{{Time ago| June 1, 2009|spellout=auto}}→ 15 nî í-chêng{{Time ago| June 1, 1999|spellout=auto}}→ 25 nî í-chêng{{Time ago| June 1, 1989|spellout=yes|spelloutmax=15}}→ 35 nî í-chêng{{Time ago| June 1, 1989|spellout=yes|spelloutmax=25}}→ 35 nî í-chêng{{Time ago|195909}}→ 16 tiám-cheng í-chêng- Wrong:
{{Time ago|196009}}→ í-chêng
TemplateData
siu-káiSee the monthly error report for this template.
TemplateData for Time ago
This template calculates the amount of time which has passed since a provided timestamp.
| 參數 | 描述 | 類型 | 狀態 | |
|---|---|---|---|---|
| Timestamp | 1 | Base timestamp for calculation of passed time. Example format: Nov 6 2008, see template documentation for other supported formats. | 字串 | 必填 |
| magnitude | magnitude | Explicitly sets a specific unit to display return value. Allowed values are: seconds, minutes, hours, days, weeks, months and years. | 字串 | 非必填 |
| min_magnitude | min_magnitude | Sets a minimum unit to display return value. Allowed values are: seconds, minutes, hours, days, months and years. | 字串 | 非必填 |
| ago | ago | Override the default usage of the text 'ago'. If it is blank but not missing then 'ago' will be removed completely; for future dates, this will remove the text 'time' as well. | 字串 | 非必填 |
| Purge link | purge | Add the parameter purge=yes to add a WP:PURGE link. | 字串 | 非必填 |
| Spell out numbers | spellout | If set to "yes", "y", "true" or "1", numbers from 1 to 100 are spelled out as English words. If set to "auto", numbers from 1 to 9 are spelled out. | 行 | 非必填 |
| Spell out max | spelloutmax | The maximum number to be spelled out as an English word. | 數值 | 非必填 |
See also
siu-kái- {{Last edited by}}
- {{Years or months ago}}
- {{Age}}
- {{Start date and age}}
- {{Birth date and age}}