Teimpléad:Date table sorting/doc

Úsáidtear Sórtáil tábla dáta chun dátaí a shórtáil agus a thaispeáint i gceart i dtábla in-sórtáilte (féach Help:Sortable tables).

Cad a réitíonn sé

Má dhéantar dátaí ina bhformáidí gnáth a chóireáil mar shreanga téacs alfa-uimhriúla amháin, sórtáiltear iad ar bhealach míloighciúil:

• Sórtáiltear 1 September 1998 roimh 5 March 1967 go haibítreach, mar tá 1 níos lú ná 5;
• Sórtáiltear February 5, 1922 roimh January 3, 1922 go haibítreach, mar tagann F roimh J.

Réiteodh úsáid na formáide YYYY-MM-DD an fhadhb seo, ach le roinnt eisceachtaí beaga ní úsáidtear an fhormáid sin in ailt (féach WP:DATEFORMAT).

Ceanglaíonn an teimpléad seo “eochair i bhfolach” le dátaí go huathoibríoch, rud a chuireann ar a gcumas sórtáil i gceart agus iad fós á dtaispeáint i gceann de na formáidí gnáth mar February 5, 1922 nó 5 Feb 1922.

Paraiméadair

Dátaí

Is féidir an bhliain, an mhí agus an lá a chur isteach ar leithligh nó mar dháta amháin.

{{Date table sorting|year|month|day|BC}}	{{Date table sorting|date}}
1ú paraiméadar – Bliain (roghnach má thugtar mí) Léiríonn uimhreacha dearfacha (1 go 999,999,999,999) blianta AD nó BC (ag brath ar an gceathrú paraiméadar). Léiríonn uimhreacha diúltacha (−1 go −999,999,999,999) blianta BC (gan an ceathrú paraiméadar). Ní mór nach mbeidh camóga ná formáidiú eile i líon na bliana. 2ú paraiméadar – Mí (roghnach mura dtugtar lá) Ainm iomlán na míosa – m.sh. February Leagan giorraithe den mhí – m.sh. Feb Uimhir na míosa – (le nialas tosaigh nó gan é) m.sh. 2 nó 02 3ú paraiméadar – Lá (roghnach) Uimhir an lae – (le nialas tosaigh nó gan é) m.sh. 7 nó 07 4ú paraiméadar – (roghnach) Is féidir BC, AD, BCE nó CE a úsáid Úsáidtear é le huimhir dhearfach bliana	1ú paraiméadar – an dáta iomlán De réir réamhshocraithe, déantar an fhormáid YYYY-MM-DD a thaispeáint mar mhí-lá-bliain agus déantar DD-MM-YYYY mar lá-mí-bliain, agus fanann formáidí eile san ord inar cuireadh isteach iad. Glactar le míonna giorraithe agus taispeántar iad giorraithe san aschur. Ceartaítear earráidí i gcaipitliú agus i gcamóga. Léirmhínítear uimhir aonair mar bhliain; murach sin déanann an modúl an dáta a pharsáil. Glactar leis na formáidí seo a leanas: YYYY-MM-DD DD-MM-YYYY DD Month YYYY Month DD, YYYY YYYY-MM DD Month Month DD Month YYYY YYYY Month Is féidir le huimhreacha lae agus míosa a bheith 1 nó 2 dhigit, agus ní féidir le huimhreacha bliana ach 3 nó 4 dhigit a bheith. Má theastaíonn uimhir níos lú ná 1000 uait, úsáid nialais tosaigh (m.sh. "0700"). Ní féidir blianta BC a pharsáil ach amháin má tá an dáta ina uimhir bliana amháin. Más gá an lá nó an mhí a chur le blianta BC nó le blianta níos mó ná 9999, ní mór paraiméadair ar leith a úsáid don bhliain, don mhí agus don lá.

Formáidiú

Nuair a úsáidtear formáid sa pharaiméadar |format=, mar shampla dmy, cruthaítear formáid a bhraitheann ar fhormáid an dáta a tugadh isteach, ach nach gá go mbeidh sí comhionann léi. Is féidir leis an bparaiméadar |format= naoi luach a ghlacadh.

Samplaí

luach	feidhm	cód ionchuir	eochair sórtála i bhfolach	aschur infheicthe

Giorrú

Tá dhá bhealach ann ainm na míosa a ghiorrú.

1. Cuir isteach ainm giorraithe na míosa go díreach.
2. Úsáid an paraiméadar |abbr=on. Is féidir é a chur roimh an dáta nó ina dhiaidh sa teimpléad. Ligeann sé seo an mhí a ghiorrú níos déanaí má éiríonn an tábla ró-leathan. Is furasta cuardach-agus-ionadú a úsáid in eagarthóir téacs nó san eagarthóir vicitéacs chun {{Date table sorting| a athrú go {{Date table sorting|abbr=on|.

Eochair sórtála bhreise

Má tá dhá dháta sa tábla mar an gcéanna, is féidir iad a ordú leis an bparaiméadar addkey.

Fillte

Is féidir le fillte an dáta cabhrú le colún agus tábla a dhéanamh níos cúinge. Chun fillte a cheadú úsáid an paraiméadar |nowrap=off. Chun é a dhéanamh níos cúinge fós úsáid |abbr=on mar a mhínítear thuas. Cabhraíonn an dá pharaiméadar seo le táblaí leathana, scáileáin chaola, fóin phóca, srl.

TemplateData

Cur síos: Úsáidtear Sórtáil tábla dáta chun dátaí a shórtáil agus a thaispeáint i gceart i dtábla in-sórtáilte.

Nótaí

Sórtáil do dhátaí neamhiomlána

• Míonna nó blianta iomlána: Sórtáiltear bliain iomlán nó mí (agus bliain) de réir a chéad lae.
• Blianta ar iarraidh: Mura sonraítear an bhliain, sórtáiltear an dáta amhail is dá mba í an bhliain reatha í.
• Dátaí folmha: Mura gcuirtear dáta ar bith isteach, úsáidtear an eochair sórtála is mó is féidir ionas go sórtálfar an iontráil go deireanach.

Rogha féilire

Ní féidir leis an teimpléad dátaí féilire Iúlach agus Ghréagórach a idirdhealú. Ní féidir leis dáta ó fhéilire amháin a ghlacadh mar ionchur agus dáta sa fhéilire eile a thabhairt mar aschur ach an oiread. Chun sórtáil cheart a chinntiú, ní mór d’eagarthóirí féilire amháin a úsáid do gach dáta, nó dáta athraithe ar leith a roghnú (m.sh. a chinneadh go bhfuil 4 October 1582 Iúlach agus go bhfuil gach dáta ina dhiaidh sin Gréagórach). Déantar é seo ar bhonn ailt-ar-alt. Tá sé de fhreagracht ar eagarthóirí freisin a mhíniú don léitheoir an bhfuil na dátaí infheicthe Iúlach nó Gréagórach má tá seans ar bith mearbhall.

Nascadh

Roimhe seo chuir an teimpléad nasc le dátaí go huathoibríoch, agus úsáideadh |link=off chun é sin a chosc. De réir na dtreoirlínte reatha, ní thacaítear a thuilleadh le nascadh dátaí agus ba chóir aon úsáid de |link=off a bhaint.

Láimhseáil earráidí

Rianaítear earráidí i Category:Date table sorting templates with errors.

Féach freisin

• {{sort}}, sórtáil de réir eochair shonraithe (úsáideach freisin do uimhreacha casta, m.sh. nodaireacht eolaíoch)
• {{sortname}}, sórtáil ainm iomlán (le “sloinne, céadainm” mar eochair réamhshocraithe)
• {{tts}}, chun amanna a shórtáil i dtáblaí torthaí d’imeachtaí lúthchleasaíochta
• {{Number table sorting}}, do uimhreacha
• {{Year in date-sorted table}}, chun blianta a shórtáil i gcolún le |data-sort-type=date