Ayuda:Funciones - Historial de revisiones

Humberto0601ad jc: /* #time */

2011-11-12T22:01:23Z

‎#time

Mostrar los cambios

Humberto0601ad jc: /* #time */

2011-11-12T21:54:37Z

‎#time

Humberto0601ad jc: /* #rel2abs */

2011-11-12T21:34:46Z

‎#rel2abs

Humberto0601ad jc: /* #ifexist */

2011-11-12T21:32:06Z

‎#ifexist

Humberto0601ad jc: /* #iferror */

2011-11-12T21:27:10Z

‎#iferror

Humberto0601ad jc: /* #ifexpr */

2011-11-12T21:25:06Z

‎#ifexpr

Humberto0601ad jc: /* #ifeq */

2011-11-12T21:24:07Z

‎#ifeq

Humberto0601ad jc: /* #if */

2011-11-12T21:22:08Z

‎#if

Humberto0601ad jc: /* #switch */

2011-11-12T21:17:39Z

‎#switch

Humberto0601ad jc: /* Advertencias */

2011-11-12T21:08:41Z

‎Advertencias

← Revisión anterior		Revisión del 21:54 12 nov 2011
Línea 238:		Línea 238:

	==#time==		==#time==
		+
		+	Esta función toma un ''<format string>'' –''cadena de texto''– según la sintaxis dada –a la derecha–, y lo maneja como un constructor para devolver otra ''cadena de texto'' de fecha, hora o calendario.<br />Por defecto, devuelve la fecha/hora en que la página –que contiene la función– fue mostrada por última vez, tal y como especifica el valor de la [[Ayuda:Palabras reservadas\|palabra mágica]] <tt><nowiki>{{CURRENTTIMESTAMP}}</nowiki></tt><br />Pero también se puede pasar como parámetro un ''<tt><''objeto fecha/hora''></tt>'', para que la cadena devuelta por la función, sea de acuerdo al objeto pasado.
		+
		+	La lista de ''<format string>'' aceptados, aparece en la tabla de la derecha; de esta manera, cualquier carácter que se pase en la ''<format string>'', y que no esté en dicha tabla, quedará inalterado en la cadena de texto devuelta por la función.
		+
		+	:<tt><nowiki>{{#time: d-m-Y }}</nowiki> → '''{{#time: d-m-Y }}'''</tt>
		+	:<tt><nowiki>{{#time: d m [[Y]] }}</nowiki> → '''{{#time: d m [[Y]] }}'''</tt>
		+	:<tt><nowiki>{{#time: i's" }}</nowiki> → '''{{#time: i's" }}'''</tt>
		+
		+	Hay dos maneras de usar algún caracter en la ''<format string>'' que sea habitualmente reconocido como ''constructor'' (ej: '''<tt>m</tt>''', '''<tt>d</tt>''', '''<tt>A</tt>'''...), para que no sea empleado como tal en una ocasión particular:
		+	#Una ''backslash'' ('''<tt>\</tt>''') seguida de cualquier caracter, se interpreta como que se desea usar sólo ese caracter de forma literal.
		+	#Cualquier caracter o caracteres, encerrado/s entre "''comilla doble''", se interpreta como que se desea usar sólo ese o esos caracteres.
		+	:<tt><nowiki>{{#time: "día" d \de m \d\e\l Y }}</nowiki> → '''{{#time: "día" d \de m \d\e\l Y }}'''</tt>
		+	:<tt><nowiki>{{#time: [[Y (year)]] }}</nowiki> → '''{{#time: [[Y (year)]] }}'''</tt>
		+	:<tt><nowiki>{{#time: [[Y "(year)"]] }}</nowiki> → '''{{#time: [[Y "(year)"]] }}'''</tt>
		+
		+	<div style="font-size:1.1em;margin-top:1.1em;">'''Usar una hora distinta a la actual'''</div>
		+
		+	Por defecto, los datos de fecha/hora/calendario, devueltos por la función, son de acuerdo al momento actual; pero se puede hacer que la función <tt>#time:</tt> trabaje en función de un momento determinado. Para ello, se usa el parámetro opcional ''<tt><objeto fecha/hora></tt>''.<br />
		+
		+	El parámetro ''<tt><objeto fecha/hora></tt>'' deberá tener un formato aceptado por la función de PHP: [http://uk3.php.net/manual/en/function.strtotime.php strtotime()], y podrá ser tanto absoluto (ej: ''<tt>20 December 2000</tt>''), como relativo al actual (ej: ''<tt>+20 hours</tt>'').
		+
		+	:<nowiki>{{#time: d F Y \| 15 April 1999 }}</nowiki> → '''{{#time: d F Y \| 15 April 1999 }}
		+	:<nowiki>{{#time: d F Y \| 15 April 1999 +4 days}}</nowiki> → '''{{#time: d F Y \| 15 April 1999 +4 days}}
		+	:<nowiki>{{#time: d F Y \| +4 days}}</nowiki> → '''{{#time: d F Y \| +4 days}}
		+
		+	{{Sistema:Metaplantilla de avisos
		+	\| tipo = serio
		+	\| imagen = [[Imagen:Mano-icon-rojo.png\|40px]]
		+	\| estilo =
		+	\| texto =
		+	'''Advertencia'''<br /><br />El rango aceptable para ''<tt><objeto fecha/hora></tt>'', está entre el ''1 de Enero del año 100'', y el ''31 de diciembre del 9999''. Cualquier valor fuera de este rango, devolverá un error.<br />
		+	<tt><nowiki>{{#time: d F Y \| 15 April 10000 }}</nowiki> → '''{{#time: d F Y \| 15 April 10000 }}</tt>}}
		+
		+	Se puede usar como ''<tt><objeto fecha/hora></tt>'', una cadena con algunos parámetros sin especificar, en cuyo caso la función usará el valor ''actual'' del parámetro que falte:
		+
		+	:<tt><nowiki>{{#time: d/m/Y \| January 1 }}</nowiki> → '''{{#time: d/m/Y \| January 1 }}</tt>
		+
		+	{{Sistema:Metaplantilla de avisos
		+	\| tipo = serio
		+	\| imagen = [[Imagen:Mano-icon-rojo.png\|40px]]
		+	\| estilo =
		+	\| texto =
		+	'''Advertencia'''<br /><br />Esta característica de la función, que permite ''rellenar'' los datos no especificados, no es ''consistente''; en algunas ocasiones, se rellenan con los datos del momento actual, pero en otras ocasiones no.<br />
		+	<tt><nowiki>{{#time: d/m/Y \| Jan 1 }}</nowiki> → '''{{#time: d/m/Y \| January 1 }}</tt><br />
		+	<tt><nowiki>{{#time: d/m/Y \| Feb 2007 }}</nowiki> → '''{{#time: d/m/Y \| February 2007 }}</tt> <small>Refiere al inicio del mes, y no al actual.</small>
		+	}}
		+
		+	Si se especifica en ''<tt><objeto fecha/hora></tt>'', un número de cuarto dígitos, este será interpretado, de ser posible, como una hora del tipo: ''hora:minuto''; si no se puede interpretar como una hora válida, se interpretará como un año.
		+
		+	:<tt><nowiki>{{#time: Y H:i \| 1959 }}</nowiki> → '''{{#time: Y H:i \| 1959 }}</tt> <small>Se interpreta como una hora.</small>
		+	:<tt><nowiki>{{#time: Y H:i \| 1960 }}</nowiki> → '''{{#time: Y H:i \| 1960 }}</tt> <small>Se interpreta como año, pues las ''19:60'' no es hora válida.</small>
		+
		+	La función también hace cálculos matemáticos, cuando se pasan días que no corresponden al número de días posibles del mes pasado como parámetro.
		+
		+	:<tt><nowiki>{{#time: d F Y \| Jan 0 2008 }}</nowiki> → '''{{#time: d F Y \| Jan 0 2008 }}</tt> <small>Toma ''0'', como día 31 del mes anterior.</small>
		+	:<tt><nowiki>{{#time: d F Y \| Feb 29 2007 }}</nowiki> → '''{{#time: d F Y \| Feb 29 2007 }}</tt> <small>Suma los días ''de más'' al mes siguiente.</small>
		+	:<tt><nowiki>{{#time: d F Y \| Feb 29 2008 }}</nowiki> → '''{{#time: d F Y \| Feb 29 2008 }}</tt> <small>Tiene en cuenta los años bisiestos.</small>
		+
		+	La función reconoce un gran número de zonas horarias:
		+
		+	:<tt><nowiki>{{#time:c\|12:30PM AZOT}}</nowiki></tt> → '''{{#time:r\|12:30PM AZOT}}
		+	:<tt><nowiki>{{#time:c\|12:30PM Europe/Madrid }}</nowiki></tt> → '''{{#time:r\|12:30PM Europe/Madrid }}
		+
	==#titleparts==		==#titleparts==

← Revisión anterior		Revisión del 21:34 12 nov 2011
Línea 173:		Línea 173:

	==#rel2abs==		==#rel2abs==
		+
		+	Esta función convierte una ruta relativa, en una ruta absoluta, pasándosele la ''<ruta relativa>'', y la ''<ruta base>''.
		+
		+	Para la ''<ruta relativa>'' se acepta la siguiente sintaxis:
		+	*<code>.</code> → el nivel actual
		+	*<code>..</code> → ''"ir a un nivel superior"''
		+	*<code>/foo/foo2</code> → ''"bajar a un nivel inferior, dentro del subdirectorio: <tt>/foo/foo2</tt>"''
		+
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../. \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ../. \| {{ns:12}}:Foo/bar/baz }}</tt>
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ./quok \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ./quok \| {{ns:12}}:Foo/bar/baz }}</tt>
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../quok \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ../quok \| {{ns:12}}:Foo/bar/baz }}</tt>
		+
		+	Si no se especifica la ''<ruta base>'', se considerará a esta, como la de la página que ejecuta la ''parser function''.
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../quok \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ../quok \| {{ns:12}}:Foo/bar/baz }}</tt>
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../quok <nowiki>}}</nowiki> → '''{{#rel2abs: ../quok}}</tt>
		+
		+	Si se hace uso de <code>../</code> en mayor número que rutas superiores tenga la ''<ruta base>'', la función devolverá ''error''.
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../../quok \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ../../quok \| {{ns:12}}:Foo/bar/baz }}</tt>
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../../../quok \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ../../../quok \| {{ns:12}}:Foo/bar/baz }}</tt>
		+	:<tt><nowiki>{{#rel2abs:</nowiki> ../../../../quok \| {{ns:12}}:Foo/bar/baz <nowiki>}}</nowiki> → '''{{#rel2abs: ../../../../quok \| {{ns:12}}:Foo/bar/baz }}</tt>
		+
	==#switch==		==#switch==

@@ Línea 133: / Línea 133: @@
 ==#ifexist==
 ==#rel2abs==
 ==#switch==

@@ Línea 115: / Línea 115: @@
 ==#iferror==
 ==#ifexist==
 ==#rel2abs==

@@ Línea 103: / Línea 103: @@
 ==#ifexpr==
 ==#iferror==
 ==#ifexist==

@@ Línea 59: / Línea 59: @@
 ==#if==
 ==#ifeq==
 ==#ifexpr==

@@ Línea 65: / Línea 65: @@
 ==#rel2abs==
 ==#switch==
 ==#time==
 ==#titleparts==
@@ Línea 94: / Línea 136: @@
 ==Advertencias==
 ===Sustitución===
 ===Tablas ===
-Las ''parser functions'' pueden arruinar la [[Help:Tables|sintaxis de las wikitablas]], tomando todos los caracteres de una celda, como parámetros de la función (en tanto que se usa el mismo caracter para separar celdas, que para separar parámetros &laquo;<tt>|</tt>&raquo; dentro de una ''parser function'').<br /> Hay dos maneras de evitar este inconveniente:<br />
+Las funciones pueden arruinar la sintaxis de las wikitablas, tomando todos los caracteres de una celda, como parámetros de la función (en tanto que se usa el mismo caracter para separar celdas, que para separar parámetros &laquo;<tt>|</tt>&raquo; dentro de una ''parser function'').<br /> Hay dos maneras de evitar este inconveniente:<br />
 * Para evitar esto, la mayoría de las wikis disponen de la plantilla [[{{ns:10}}:!|<nowiki>{{</nowiki>{{ns:10}}:!}}]], cuyo contenido es el caracter en cuestión &laquo;<tt>|</tt>&raquo;. Esto, ''oculta'' el caracter problemático para el analizador de MediaWiki, asegurando que no se tenga encuenta el mismo, hasta que todas las plantillas, variables y funciones, hayan sido expandidas.
 * También se puede usar la sintaxis de tablas propia del ''HTML''.