Campo de Formulario, Tipo calendar
From Joomla! Documentation
Proporciona un cuadro de texto para la entrada de una fecha. Un icono situado junto al cuadro de texto proporciona un enlace a un calendario emergente, que también puede ser utilizado para introducir el valor de la fecha. Si el campo tiene un valor guardado este se muestra en el campo de texto. De lo contrario, se muestra el valor predeterminado, si hay alguno.
- type (obligatorio) debe ser calendar.
- name (obligatorio) es el nombre único del parámetro.
- label (obligatorio) (traducible) es el título descriptivo del campo.
- default (opcional) es el valor predeterminado de la fecha. Esta debe ser dada en el mismo formato que el especificado por el argumento formato. Puede poner "NOW" para tener la información de la fecha u hora del momento en el formato establecido.
- description (opcional) (traducible) es el texto que será mostrado como un texto de ayuda cuando el usuario mueve el ratón sobre el cuadro de texto.
- readonly (opcional) indica si el cuadro de texto de sólo lectura (true o false). Si el cuadro de texto es de sólo lectura, la fecha no se puede cambiar, pero se puede seleccionar y copiar. No hay icono de calendario.
- disabled (opcional) indica si el cuadro de texto está desactivado (true o false). Si el cuadro de texto está desactivado, la fecha no puede ser cambiada, seleccionada o copiada.
- class (opcional) es un nombre de clase CSS para el campo del formulario HTML.
- formato (opcional) es el formato de fecha a ser utilizado. Este es el formato utilizado por PHP para especificar el formato de cadenas de fechas (ver más abajo). Si no se da ningún argumento al formato, se supone '%Y-%m-%d' (dando fechas como '2008-04-16').
- 'filter (opcional) es el la zona horaria a ser utilizada. Hay dos valores; server_utc y user_utc. El primero es la zona horaria del servidor y el segundo es la zona horaria del usuario, según este configurado en la configuración global y la información del usuario, respectivamente.
Ejemplo de Definición XML:
<field name="mycalendar" type="calendar" default="5-10-2008" label="Select a date" description="" format="%d-%m-%Y" />
El atributo formato especifica el formato con el qeu se guardará la cadena de fecha. También es el formato en que las fechas deberán ser entradas manualmente; salvo que el carácter de puntuación sea ignorado. El esquema de codificación utilizado para especificar los formatos de fecha es una definición personal para la biblioteca javascript utilizado en el selector de fecha, los detalles completos se pueden encontrar por ejemplo en Github deJoomlaǃ. Los siguientes son algunas de las cadenas de códigos más utilizados para las fechas:
Carácter | Descripción | Ejemplo |
---|---|---|
d | Día del mes, 2 dígitos con ceros a la izquierda | 01 a 31 |
a | Abreviatura de un día, tres letras | Lun a Dom |
e | Día del mes sin ceros a la izquierda | 1 a 31 |
A | El nombre completo de los días de la semana | Lunes a Domingo |
w | Representación numérica del día de la semana | 0 (para domingo) a 6 (para Sábado) |
j | El día del año (a partir de 0) | 001 a 366 |
B | El nombre completo de un mes | Enero a Diciembre |
m | Representación numérica de un mes, con ceros a la izquierda | 01 a 12 |
b | A short textual representation of a month, three letters | Jan through Dec |
Y | A full numeric representation of a year, 4 digits | 1999 or 2003 |
y | A two-digit representation of a year | 99 or 03 |
p | Lowercase Ante Meridiem or Post Meridiem | am or pm |
P | Uppercase Ante Meridiem or Post Meridiem | AM or PM |
Note: The format in which dates are stored in the params.ini file is that specified by the format argument. Since there can be language-dependent elements to this format (for example, the '%A' specifier), you need to be careful not to use such elements if there is a possibility that the front-end and back-end languages may be different.
Note: The calendar form field type does not support non-Gregorian calendars. If you need to support non-Gregorian calendars then you will need to create a custom form field type to support your calendar.
Standard associated filters
- user_utc - Calculates the specified value to the time of Greenwich, according to the user time zone settings.