Ver el código de «Módulo:Edad/doc»

'''Nota Importante:''' Este módulo está en proceso de adaptación de {{URL|https://en.wikipedia.org/wiki/Module:Age|Module:Age}} al español para poder soportar la funcionalidad de todas las plantillas de edad que se utilizan en la Wikipedia en español. 
La idea es que sea un reemplazo único para todas las plantillas de edad existentes para juntar toda la implementación en un sitio y hacerla más fácil de mantener.
Se agradece muchísimo el impecable trabajo original de {{URL|https://en.wikipedia.org/wiki/User:Johnuniq|User:Johnuniq}} sin el cual esto no sería posible.

== Plantillas implementadas  ==
[[Módulo:Edad]] implementa las siguientes plantillas:
Las últimas dos columnas representan:
* Adaptado a español: si la implementación del módulo se ha adaptado para aceptar los parámetros de la actual implementación de sus respectivas plantillas.
* En uso: si la implementación actual de esa plantilla en español utiliza éste módulo.
{| class="wikitable"
! Plantilla                                   !! Wikitexto de la plantilla                                                                !! Adaptado a español          !! En uso
|-
| {{ep|intervalo tiempo}}                     || <code><nowiki>{{#invoke:edad|time_interval}}</nowiki></code>                             || {{Celda|Sí|Completo}}       || {{Celda|Sí}}
|- 
| {{ep|edad en días}}                         || <code><nowiki>{{#invoke:edad|age_generic|template=age_days}}</nowiki></code>             || {{Celda|ff9900|Parcial}}     || {{Celda|No}}
|-
| {{ep|duración en días}}                     || <code><nowiki>{{#invoke:edad|age_generic|template=duration_days}}</nowiki></code>        || {{Celda|Sí|Completo}}       || {{Celda|Sí}}
|-
| {{ep|edad}}                                 || <code><nowiki>{{#invoke:edad|age_generic|template=age_full_years}}</nowiki></code>       || {{Celda|Sí|Completo}}       || {{Celda|pendiente}}
|-
| {{ep|edad en años}}                         || <code><nowiki>{{#invoke:edad|age_generic|template=age_in_years}}</nowiki></code>         || {{Celda|Sí|Completo}}       || {{Celda|pendiente}}
|-
| {{ep|edad en meses}}                        || <code><nowiki>{{#invoke:edad|age_generic|template=age_m}}</nowiki></code>                || {{Celda|Sí|Completo}}       || {{Celda|Sí}}
|-
| {{ep|edad en semanas}}                      || <code><nowiki>{{#invoke:edad|age_generic|template=age_w}}</nowiki></code>                || {{Celda|Sí|Completo}}       || {{Celda|Sí}}
|-
| {{ep|edad en años y días}}                  || <code><nowiki>{{#invoke:edad|age_generic|template=age_yd}}</nowiki></code>               || {{Celda|Sí|Completo}}       || {{Celda|pendiente}}
|-
| {{ep|edad en años y meses}}                 || <code><nowiki>{{#invoke:edad|age_generic|template=age_ym}}</nowiki></code>               || {{Celda|Sí|Completo}}       || {{Celda|Sí}}
|-
| {{ep|edad en años, meses y días}}           || <code><nowiki>{{#invoke:edad|age_generic|template=age_ymd}}</nowiki></code>              || {{Celda|ff9900|Parcial}}    || {{Celda|pendiente}}
|}

Las plantillas de edad esperan recibir la fecha más antigua primero Las implementaciones de <code>age_in_years</code> y <code>age_in_years_nts</code> muestran un mensaje de error si no es así. Si se necesita una comprobación similar en otras plantillas, se puede añadir <code>negative=error</code> al invoke. Por ejemplo, {{ep|edad}} podría usar:
*<code><nowiki>{{#invoke:edad|age_generic|template=age_full_years|negative=error}}</nowiki></code>
Si no se aplica <code>negative=error</code> la diferencia negativa se muestra con un signo menos (−).

== Formatos de Fecha ==
Las fechas pueden usar parámetros numerados o nombrados para especificar el día/mes/año. De forma alternativa, una fecha completa se puede introducir en una variedad de formatos. Por ejemplo:
*<code><nowiki>{{edad en años y meses|a1=2001|m1=1|d1=10|a2=2012|m2=2|d2=20}}</nowiki></code> → {{edad en años y meses|a1=2001|m1=1|d1=10|a2=2012|m2=2|d2=20}}
*<code><nowiki>{{edad en años y meses|a=2001|m=1|d=10|a2=2012|m2=2|d2=20}}</nowiki></code> → {{edad en años y meses|a=2001|m=1|d=10|a2=2012|m2=2|d2=20}}
*<code><nowiki>{{edad en años y meses|10|1|2001|20|2|2012}}</nowiki></code> → {{edad en años y meses|10|1|2001|20|2|2012}}
*<code><nowiki>{{edad en años y meses|2001-1-10|2012-2-20}}</nowiki></code> → {{edad en años y meses|2001-1-10|2012-2-20}}
*<code><nowiki>{{edad en años y meses|10 ene 2001|20 feb 2012}}</nowiki></code> → {{edad en años y meses|10 ene 2001|20 feb 2012}}
*<code><nowiki>{{edad en años y meses|10 de enero de 2001|20 de febrero de 2012}}</nowiki></code> → {{edad en años y meses|10 de enero de 2001|20 de febrero de 2012}}
*<code><nowiki>{{edad en años y meses|enero 10, 2001|feb 20, 2012}}</nowiki></code> → {{edad en años y meses|enero 10, 2001|feb 20, 2012}}

Si se omite una de las dos fechas, se utiliza la actual en su lugar. Por ejemplo:
*<code><nowiki>{{edad en años y meses|a2=2012|m2=2|d2=20}}</nowiki></code> → {{edad en años y meses|a2=2012|m2=2|d2=20}}
*<code><nowiki>{{edad en años y meses||||20|2|2012}}</nowiki></code> → {{edad en años y meses||||20|2|2012}}
*<code><nowiki>{{edad en años y meses||2012-2-20}}</nowiki></code> → {{edad en años y meses||2012-2-20}}
*<code><nowiki>{{edad en años y meses||20 feb 2012}}</nowiki></code> → {{edad en años y meses||20 feb 2012}}
*<code><nowiki>{{edad en años y meses||feb 20, 2012}}</nowiki></code> → {{edad en años y meses||feb 20, 2012}}
*<code><nowiki>{{edad en años y meses|a1=2001|m1=1|d1=10}}</nowiki></code> → {{edad en años y meses|a1=2001|m1=1|d1=10}}
*<code><nowiki>{{edad en años y meses|year=2001|month=1|day=10}}</nowiki></code> → {{edad en años y meses|year=2001|month=1|day=10}}
*<code><nowiki>{{edad en años y meses|10|1|2001|}}</nowiki></code> → {{edad en años y meses|10|1|2001|}}
*<code><nowiki>{{edad en años y meses|2001-1-10}}</nowiki></code> → {{edad en años y meses|2001-1-10}}
*<code><nowiki>{{edad en años y meses|10 ene 2001}}</nowiki></code> → {{edad en años y meses|10 ene 2001}}
*<code><nowiki>{{edad en años y meses|10 de enero de 2001}}</nowiki></code> → {{edad en años y meses|10 de enero de 2001}}
*<code><nowiki>{{edad en años y meses|enero 10, 2001}}</nowiki></code> → {{edad en años y meses|enero 10, 2001}}

== Parámetros ==
The following options are available:
{| class="wikitable"
! Parámetro !! Descripción
|-
| <code>duration=on</code> || La fecha final está incluida en el resultado añadiendo un día a la edad.
|-
| <code>fix=on</code> || Ajusta unidades de tiempo no válidas Ver "Template:Extract#Fix" (Pendiente de traducir).
|-
| <code>format=commas</code> || Un valor de 1000 o mayor aparece con comas como separadores.
|-
| <code>format=raw</code> || Los números se muestran sin comas y los negativos con un guión para <code><nowiki>{{#expr}}</nowiki></code>. Además, {{ep|age}} devuelve el número tal cual sin el span con información.
|-
| <code>format=cardinal</code> || Mostrar el número resultante en texto utilizando palabras como "cinco" en lugar de 5. Ver [[#Deletrear números|más abajo]].
|-
| <code>format=ordinal</code> || Mostrar el número resultante utilizando palabras como "quinto" en vez de 5. Ver [[#Deletrear números|más abajo]].
|-
| <code>prefix=''texto''</code> || Inserta el ''texto'' antes del resultado pero después de una clave de ordenación. Por ejemplo, <code><nowiki>{{edad|23 de julio de 1910|14 de julio de 1976|prefix=sobre|sortable=on}}</nowiki></code> devuelve una clave de ordenación oculta seguida de "sobre 65".
|-
| <code>range=dash</code> || Aceptar un año solo o año y mes y devolver un rango de edades separadas por [[Raya (puntuación)|un guión largo]] (–).
|-
| <code>range=yes</code> || Aceptar un año o mes/año y mostrar el rango separado por "or".
|-
| <code>range=no</code> || Aceptar un año o mes/año, pero mostrar solo una edad como si se hubiesen introducido fechas completas.
|-
| <code>round=on</code> || La edad se redondea a la unidad de tiempo menos significativa más cercana.
|-
| <code>sc=on</code> || Se utiliza la [[en:serial comma|coma de Oxford]] (solo útil si se muestran tres o más valores).
|-
| <code>sc=yes</code> || Igual que <code>sc=on</code>.
|-
| <code>show=hide</code> || No se muestra la edad; puede ser útil combinado con <code>sortable=on</code>.
|-
| <code>sortable=on</code> || Inserta una clave de ordenación oculta antes del resultado (para utilizar con [[A:TAB#Ordenables|tablas ordenables]]).
|-
| <code>sortable=table</code> || Inserta una clave de ordenación utilizando la sintaxis de tabla <code>data-sort-value="''value''"&#124;</code>.
|-
| <code>sortable=debug</code> || Igual que <code>sortable=on</code> pero mostrando la clave de ordenación. Usado solo para testear.
|-
| <code>sortable=off</code> || Sin clave de ordenación, si se incluye puede sobreescribir el valor por defecto de plantillas como {{ep|edad nts}}).
|-
| <code>ceros=yes</code> || Muestra los campos que dan cero en la diferencia ('1 año, 0 meses y 3 días' VS '1 año y 3 días').
|}

Algunos ejemplos de uso del parámetro <code>range</code> se muestran a continuación.
*<code><nowiki>{{edad en años y meses|year=2001|month=1|a2=2012|m2=2|range=yes}}</nowiki></code> → {{edad en años y meses|year=2001|month=1|a2=2012|m2=2|range=yes}}
*<code><nowiki>{{edad en años y meses||1|2001|2|2012|range=yes}}</nowiki></code> → {{edad en años y meses||1|2001|2|2012|range=yes}}
*<code><nowiki>{{edad en años y meses|ene 2001|feb 2012|range=yes}}</nowiki></code> → {{edad en años y meses|ene 2001|feb 2012|range=yes}}
*<code><nowiki>{{edad en años y meses|ene 2001|febrero de 2012|range=dash}}</nowiki></code> → {{edad en años y meses|ene 2001|febrero de 2012|range=dash}}
*<code><nowiki>{{edad en años y meses|ene 2001|feb 2012|range=no}}</nowiki></code> → {{edad en años y meses|ene 2001|feb 2012|range=no}} {{verde|1=(se asume el 1 de enero de 2001 al 1 de febrero de 2012)}}
*<code><nowiki>{{edad en años y meses|12 ene 2001|feb 2012|range=no}}</nowiki></code> → {{edad en años y meses|12 ene 2001|feb 2012|range=no}} {{verde|1=(se asume el 12 de enero de 2001 al 12 de febrero de 2012)}}
*<code><nowiki>{{edad en años y meses|2001|2012|range=no}}</nowiki></code> → {{edad en años y meses|2001|2012|range=no}} {{verde|1=(se asume el 1 de enero de 2001 al 1 de enero de 2012)}}
*<code><nowiki>{{edad en años y meses|2001|23 feb 2012|range=no}}</nowiki></code> → {{edad en años y meses|2001|23 feb 2012|range=no}} {{verde|1=(se asume el 23 de febrero de 2001 al 23 de febrero de 2012)}}

La clave de ordenación se basa en la edad en días y fracciones de los mismos si se especifica una hora.
*<code><nowiki>{{edad en años y meses|10 ene 2001|20 feb 2012|sortable=debug}}</nowiki></code> → {{edad en años y meses|10 ene 2001|20 feb 2012|sortable=debug}}
*<code><nowiki>{{edad en años y meses|10 ene 2001|6:00 am 20 feb 2012|sortable=debug}}</nowiki></code> → {{edad en años y meses|10 ene 2001|6:00 am 20 feb 2012|sortable=debug}}
*<code><nowiki>{{edad en años y meses|10 ene 2001|6:00 am 20 feb 2012|sortable=debug|show=hide}}</nowiki></code> → {{edad en años y meses|10 ene 2001|6:00 am 20 feb 2012|sortable=debug|show=hide}}

Un día extra añadido para la duración.
*<code><nowiki>{{edad en años y meses|20 ene 2001|19 feb 2012}}</nowiki></code> → {{edad en años y meses|20 ene 2001|19 ene 2012}} {{verde|1=(a un día de ser 11 años y 1 mes)}}
*<code><nowiki>{{edad en años y meses|20 ene 2001|19 feb 2012|duration=on}}</nowiki></code> → {{edad en años y meses|20 ene 2001|19 feb 2012|duration=on}}

También se puede redondear la unidad de tiempo menos significativa.
*<code><nowiki>{{edad en años y meses|20 ene 2001|10 ene 2012}}</nowiki></code> → {{edad en años y meses|20 ene 2001|10 ene 2012}}
*<code><nowiki>{{edad en años y meses|20 ene 2001|10 ene 2012|round=on}}</nowiki></code> → {{edad en años y meses|20 ene 2001|10 ene 2012|round=on}} {{verde|1=(redondeando al mes más cercano)}}

Los números grandes se pueden formatear con comas.
*<code><nowiki>{{edad en años y meses|2012|120|format=commas|range=yes}}</nowiki></code> → {{edad en años y meses|2012|120|format=commas|range=yes}}
*<code><nowiki>{{edad en años y meses|2012|120|format=commas|range=dash}}</nowiki></code> → {{edad en años y meses|2012|120|format=commas|range=dash}}

== Deletrear números ==
'''Nota:''' La traducción de [[Módulo:ConvertNumeric]] no está 100% terminada, los cardinales funcionan pero en español la distinción entre <code>cardinal</code> y <code>cardinal_us</code> no tiene sentido. Se está trabajando en ello.
'''Nota2:''' Los siguientes ejemplos no funcionarán hasta que se migre la plantilla de edad

Las plantillas que utilizan <code>age_generic</code> pueden mostrar números en forma de palabras en vez de numerales. El resultado puede ser un [[Número cardinal|número cardinal]] como "cinco" o un [[Número ordinal (matemáticas)|número ordinal]] como "quinto". Dependiendo de cómo se escriba el parámetro la primera letra será o no en mayúscula. Si indicas una fecha parcial y pides un rango de vuelta también te lo puede deletrear. Ejemplos:
*<code><nowiki>{{edad en meses|01|01|1898|01|02|2018|format=cardinal}}</nowiki></code> → {{edad en meses|01|01|1898|01|02|2018|format=cardinal}}
*<code><nowiki>{{edad en meses|01|01|1898|01|02|2018|format=Cardinal}}</nowiki></code> → {{edad en meses|01|01|1898|01|02|2018|format=Cardinal}}
*<code><nowiki>{{edad en meses|01|01|1898|01|02|2018|format=ordinal}}</nowiki></code> → {{edad en meses|01|01|1898|01|02|2018|format=ordinal}}
*<code><nowiki>{{edad en meses|01|01|1898|01|02|2018|format=Ordinal}}</nowiki></code> → {{edad en meses|01|01|1898|01|02|2018|format=Ordinal}}
*<code><nowiki>{{edad en meses|1980|1990|range=yes|format=Cardinal}}</nowiki></code> → {{edad en meses|1980|1990|range=yes|format=Cardinal}}
*<code><nowiki>{{edad en años y meses|abril 1980|1995|format=Cardinal|range=yes}}</nowiki></code> → {{edad en años y meses|abril 1980|1995|format=Cardinal|range=yes}}

== Categoría de seguimiento ==
* {{Enlace de categoría con conteo|Error de Edad}}

== Ver también ==
* {{ep|intervalo tiempo}} • Esta plantilla soporta todos los cálculos de edad/duración y provee más opciones como abreviaturas o omisión de unidades.

<includeonly>
<!-- Coloca las categorías del módulo a continuación y los interwikis en Wikidata -->
[[Categoría:Hispanopedia:Módulos]]
</includeonly>