Funcions de data
Hi ha diverses funcions de data implementades en Calculate Fields, de manera que l’usuari pot manipular les dates de moltes maneres. La majoria de les funcions fa servir un paràmetre de format, que s’utilitza per establir el resultat de les funcions formatades com desitja l’usuari. Les opcions per a aquests formats són equivalents amb els paràmetres de format PHP:
|
Formato del carácter |
Descripción | Ejemplo de valores devueltos |
| Por dia | ||
| d | Día del mes, 2 dígitos con ceros | 01 a 31 |
| D | Una representación textual de un día, tres letras | De lunes a domingo |
| j | Día del mes sin ceros a la izquierda | 1 a 31 |
| l | Una representación textual completa del día de la semana | Domingo a Sábado |
| N | Representación numérica ISO-8601 de día de la semana | 1 (para el lunes) a 7 (para el domingo) |
| S | Sufijo ordinal Inglés para el día de la mes, 2 caracteres | st, nd, rd o th. Funciona bien con j |
| w | Representación numérica del día de la semana | 0 (para el domingo) a 6 (para el sábado) |
| z | El día del año (empezando desde 0) | 0 a 365 |
| Para semana | ||
| W | ISO-8601 número de la semana del año, semanas comenzando en lunes | 42 (la 42ª semana del año) |
| Por mes | ||
| F | Una representación textual completa de un mes, | como enero o marzo |
| m | Representación numérica de un mes,con ceros a la izquierda | 01 a 12 |
| M | Una breve representación textual de un mes, tres letras | De enero a diciembre |
| n | Representación numérica de un mes, sin ceros a la izquierda | 1 a 12 |
| t | Número de días en el mes dado | 28 a 31 |
| Por año | ||
| L | Si es un año bisiesto | 1 si es un año bisiesto, 0 de lo contrario |
| o | Número de año ISO-8601. Esto tiene el mismo valor, excepto si el número de semana ISO (W) pertenece al año anterior o al siguiente, ese año se usa en su lugar | 1999 o 2003 |
| Y | Una representación numérica completa de un año, 4 dígitos | 1999 o 2003 |
| y | Una representación de dos dígitos de un año | 99 o 03 |
| Para el tiempo | ||
| a | Ante Merídiem minúscula y Post Merídiemminúscula | am o pm |
| A | Ante Merídiem mayúscula y Post Merídiem mayúscula | AM o PM |
| B | Tiempo de Internet | 000 a 999 |
| g | Formato de 12 horas de una hora sin ceros | 1 a 12 |
| G | formato de 24 horas de una hora sin ceros | 0 a 23 |
| h | formato de 12 horas de una hora con ceros | 01 a 12 |
| H | formato de 24 horas de una hora con ceros | 00 a 23 |
| i | Minutos, con ceros a la izquierda | 00 a 59 |
| s | Segundos, con ceros a la izquierda | 00 a 59 |
| Por zona horari | ||
| e | Identificador de zona horaria | UTC, GMT, Atlántico / Azores |
| l | Si la fecha es o no a la luz del día ahorrando tiempo | 1 si Horario de verano, 0 de lo contrario |
| O | Diferencia a la hora de Greenwich (GMT) en horas | +0200 |
| P | Diferencia a la hora de Greenwich (GMT) con dos puntos entre horas y minutos | +02: 00 |
| T | Abreviación de zona horaria | EST, MDT |
| Z | Huso horario en segundos. El desplazamiento para las zonas horarias al oeste de UTC siempre es negativo, y para aquellos al este de UTC siempre es positivo. | 43200 a 50400 |
| Para fecha / hora completa | ||
| c | ISO 8601 fecha | 2004-02-12T15: 19: 21 + 00: 00 |
| r | RFC 2822 fecha de formato | Jue, 21 Dec 2000 16:01:07 +0200 |
| U | Segundos desde la Época de Unix |
(1 de enero 1970 00:00:00 GMT) |
date
|
Signatura
|
{date(format; timestamp)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora |
| Devuelve | Marca de tiempo en el formato dado |
| Descripción | Crea una fecha en el formato dado |
| Ejemplo de llamada | {date(ymd; 2016-02-11)} returns 160211 |
now
|
Signatura
|
{now(format)} |
| Parámetros | format: texto de formato |
| Devuelve | Fecha / hora actual |
| Descripción | Crea la fecha / hora real en el formato dado |
| Ejemplo de llamada | {now(Y-m-d H:i:s)} returns 2016-04-2915:08:03 |
yesterday
| Signatura | {yesterday(format)} |
| Parámetros | format: texto de formato |
| Devuelve | La fecha / hora de ayer en el formato dado |
| Descripción | Crea la fecha / hora de ayer en el formato dado |
| Ejemplo de llamada | {yesterday(Y-m-d H:i:s)} returns2016-04-28 15:08:03 |
tomorrow
| Signatura | {tomorrow(format)} |
| Parámetros | format: texto de formato |
| Devuelve | La fecha / hora de mañana en el formato dado |
| Descripción | Crea la fecha / hora de mañana en el formato dado |
| Ejemplo de llamada | {tomorrow(Y-m-d H:i:s)} returns 2016-04-30 15:08:03 |
datediff
| Signatura | {datediff(timestamp1; timestamp2; unit)} |
| Parámetros | timestamp1: valor de fecha / hora
timestamp2: valor de fecha / hora unit:años / meses / días / horas / minutos / segundos; predeterminado: días |
| Devuelve | La diferencia entre las dos fechas devuelto en unit |
| Descripción | Resta la marca de timestamp1 a timestamp1 |
| Ejemplo de llamada | {datediff(2016-02-01; 2016-04-22; days)} returns 81 |
addYears
| Signatura | {addYears(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Agrega años a la marca de tiempo |
| Ejemplo de llamada | {addYears(Ymd; 2016-04-22; 1)} returns 20170422 |
addMonths
| Signatura | {addMonths(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Agrega una cantidad de meses a la marca de tiempo |
| Ejemplo de llamada | {addMonths(Ymd; 2016-04-22; 1)} returns 20160522 |
addDays
| Signatura | {addDays(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Agrega una cantidad de dias a la marca de tiempo |
| Ejemplo de llamada | {addDays(Ymd; 2016-04-22; 1)} returns 20160423 |
addHours
| Signatura | {addHours(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Agrega una cantidad de horas a la marca de tiempo |
| Ejemplo de llamada | {addHours(Ymd H:i:s; 2016-04-22 23:30;5)} returns 20160423 04:30:00 |
addMinutes
| Signatura | {addMinutes(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Agrega una cantidad de minutos a la marca de tiempo |
| Ejemplo de llamada | {addMinutes(Ymd H:i:s; 2016-04-22 22:58;5)} returns 20160422 23:03:00 |
addSeconds
| Signatura | {addSeconds(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Agrega un cantidad de segundos a la marca de tiempo |
| Ejemplo de llamada | {addSeconds(Ymd H:i:s; 2016-04-22 22:58;5)} returns 20160422 22:58:05 |
subtractYears
| Signatura | {subtractYears(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Restan años de la marca de tiempo |
| Ejemplo de llamada | {subtractYears(Ymd; 2016-04-22; 5)}returns 20110422 |
subtractMonths
| Signatura | {subtractMonths(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Restas meses desde marca de tiempo |
| Ejemplo de llamada | {subtractMonths(Ymd; 2016-04-22; 5)} returns 20151122 |
subtractDays
| Signatura | {subtractDays(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Resta días desde marca de tiempo |
| Ejemplo de llamada | {subtractDays(Ymd; 2016-04-22; 5)} returns 20160417 |
subtractHours
| Signatura | {subtractHours(format; timestamp; amount)} |
| Parámetros | format: texto de formato
timestamp: valor de fecha / hora amount: número decimal |
| Devuelve | Fecha incrementada en formato |
| Descripción | Resta horas desde marca de tiempo |
| Ejemplo de llamada | {subtractDays(Ymd; 2016-04-22; 5)} returns 20160417 |
