calendarПоле календаря формы, обеспечивает текстовое поле ввода для даты. Значок рядом с текстовым полем содержит ссылку на всплывающий
календарь, который также может быть использован для ввода значения даты. Если поле имеет сохранённое значение это будет показано в текстовое поле.

  1. type - тип пункта меню к примеру text.
  2. name - имя типа пункта меню, при записи в бд, имя пункта меню должно быть одинаковым в таблице.name 
  3. label - название поля.
  4. default - значение по умолчанию.
  5. description - описание, подсказка. Всплывающая подсказка поля при наведении мышкой.
  6. readonly - (опционально), является ли текстовое поле только для чтения (истинное или ложное). Если текстовое поле только для чтения, дата не может быть изменена, но можно выбрать и скопировать.
  7. disabled - (опционально), является ли текстовое поле отключенным (истинное или ложное). Если текстовое поле не будет, дата не может быть изменен, выбранных или скопированы.
  8. class — имя CSS класса, которое будет использоваться при выводе поля в html-код. По умолчанию «inputbox».
  9. format - (приобретается дополнительно) формат даты, которые будут использоваться. Это формат, используемый в PHP, чтобы указать формат даты строки (см. ниже). Если формат не аргумент, '% Y-% M-% D' предполагается (с указанием дат, как '20013-03-27 ').
  10. filter - (необязательно) часовой пояс, который будет использоваться. Есть два значения; server_utc и user_utc.
<field 
	name="mycalendar" 
	type="calendar" 
	default="5-10-2008" 
	label="SELECT_A_DATE" 
	description="SELECT_A_DATE_DESC" 
	format="%d-%m-%Y" />

Атрибут format определяет формат, как строка даты будет сохранена. Также формат, который должен быть интегрирован в введенные вручную даты. за исключением того, что символ пунктуации игнорируется. Схема кодирования используемая для задания форматов дат является обычно задается библиотекой JavaScript, используемой в DatePicker, подробные сведения о которых можно найти, например, на Joomla's Github. Ниже приведены некоторые из наиболее часто используемых строк кодов даты:

Символ Описание Пример
%d День месяца, 2 цифры, при необходимости с нулем в начале от 01 до 31
%a сокращенное название дня недели, три буквы Mon - Sun
%e День месяца без нуля от 1 до 31
%A полное название дня недели от Понедельника до Воскресенья
%w Порядковый номер дня недели от 0 (воскресенье)
до 6 (суббота)
%u Порядковый номер дня недели от 1 (понедельник)
до 7 (воскресение)
%j день года от 1 до 366
%B полное название месяца с Января по Декабрь
%m Числовое представление месяца, при необходимости с нулем в начале от 01 до 12
%b сокращенное название месяца, три буквы Jan - Dec
%Y Полное число года в 4 цифры 1999 или 2003
%y Год, две последовании цифры 99 или 03
%p В нижнем регистре «ДО» и «ПОСЛЕ» полудня am или pm
%P В верхнем регистре «ДО» и «ПОСЛЕ» полудня AM или PM
%C номер столетия  
%c предпочтительное представление даты и времени для текущего языка  
%D Американский стиль даты: %m/%d/%y  
%F эквивалент %Y-%m-%d (формат даты ISO 8601)  
%G указывает год как четырехзначное число (по стандарту ISO 8601). Имеет тот же формат и значение, что и %y, но если неделя входит также в прошедший (или последующий) год (в соответствии со стандартом ISO о номерах недель), то в этом случае отображается прошедший год  
%g то же, что и %G, но без первых двух чисел, то есть двухразрядное число, 00-99  
%H, %k час (формат 24 часа) от 00 до 23
%I, %l час (формат 12 часов) от 01 до 12
%M минуты от 00 до 59
%n символ новой строки  
%r время в нотации am/pm %I:%M:%S%p  
%R время в 24-часовой нотации %H:%M  
%s количество  секунд, прошедших с полуночи 1 января 1970 года GMT  
%S секунды от 00 до 59
%t символ табуляции  
%T время в 24-часовой нотации (%H:%M:%S)  
%U, %W, %V показывает номер недели текущего года в виде десятичного числа от 00 до 53, начиная с первого воскресенья как первого дня первой недели. от 00 до 53
%x предпочтительное представление даты для текущего языкового стандарта без времени  
%X предпочтительное представление времени для текущего языкового стандарта без даты  
%% символ «%»  

В разных мануалах приведены 2 конфликтующие таблицы ))) - вобщем - ХЗ - надо тестить

Ниже представлены форматы дат такие же как и в php.

Примечание: Параметр format, в котором даты хранятся в файле params.ini показывает то, что указанный формат аргумента. Так может быть, зависящие от языка элементы в этом формате (например, '%A' спецификатора), вы должны быть осторожны, чтобы не использовать такие элементы, если есть вероятность того, что front-end и back-end языки могут быть разными.

Примечание: тип календаря поле формы не поддерживает, не григорианский календари. Если вам необходимо поддерживать не-григорианские календари, то вам нужно будет создать пользовательский тип поля формы для поддержки календаря.

Стандартные связанные фильтры

  • user_utc - Вычисляет заданное значение времени Гринвича, в соответствии с настройками времени пользователем зоны.