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

  1. type - (обязательно) должен быть calendar.
  2. name - имя типа пункта меню, при записи в бд, имя пункта меню должно быть одинаковым в таблице.name 
  3. label - (обязательно) (переводимый) - это описательное название поля.
  4. default - (необязательно) - дата по умолчанию. Он должен быть задан в том же формате, что и аргумент format. Вы можете поставить "NOW" для получения информации о текущей дате или времени в заданном формате. Вы также можете использовать любые [аргументы JDate] ('now +1 month', 'now +2 months +7 days +12 hours', ...)
  5. description - (необязательно) (переводимый) - это текст, который будет показан в качестве всплывающей подсказки, когда пользователь наведет курсор мыши на текстовое поле.
  6. readonly - (необязательно) - является ли текстовое поле доступным только для чтения (true или false). Если текстовое поле предназначено только для чтения, дату нельзя изменить, но можно выделить и скопировать. Значок календаря не будет отображаться.
  7. disabled - (необязательно) - отключено ли текстовое поле (true или false). Если текстовое поле отключено, дату нельзя изменить, выбрать или скопировать.
  8. class — (необязательно) - это имя класса CSS для поля HTML-формы. Рекомендуется использовать "Bootstrap2 Relatives sizing". (см. примеры кода ниже).
  9. format - формат даты, который будет использоваться. Это формат, используемый PHP для задания форматов строк даты (см. ниже). Если аргумент формата не указан, предполагается '%Y-%m-%d' is assumed (giving dates like '2017-05-15'). (давая даты типа '2017-05-15'). Если showtime имеет значение true, то необходимо включить некоторые поля времени, например, '%Y-%m-%d %H:%M:%S'.
  10. filter - (необязательно) - часовой пояс, который будет использоваться. Существует два значения; server_utc и user_utc. Первый - это часовой пояс сервера, а второй - часовой пояс пользователя, настроенный в глобальной конфигурации и информации о пользователе соответственно.
  11. translateformat - (необязательно): Если установлено значение true, календарь будет использовать языковой ключ DATE_FORMAT_CALENDAR_DATE (если showtime - true) или DATE_FORMAT_CALENDAR_DATETIME (если showtime - false) для определения формата. Атрибут format игнорируется. Если false, то используется атрибут format (такое же поведение, как и в версии 3.7.0), но обратите внимание, что строка формата должна включать поля времени для записи времени. По умолчанию имеет значение false.
  12. showtime - (необязательно): Если установлено значение true и translateformat равен true, используется языковой ключ DATE_FORMAT_CALENDAR_DATETIME, иначе DATE_FORMAT_CALENDAR_DATE. (начиная с версии 3.7.0). По умолчанию имеет значение false.
  13. timeformat - (необязательно): может быть установлен на 12 или 24 (начиная с версии 3.7.0). Если установлено значение 12, пользователю доступен дополнительный выбор между AM и PM. Этот атрибут не влияет на способ сохранения даты/времени. По умолчанию - 24.
  14. singleheader - (необязательно): если установлено значение false, выбор года и месяца будет установлен на двух отдельных строках, с независимым выбором (начиная с версии 3.7.0). По умолчанию имеет значение false.
  15. todaybutton - (необязательно): если установлено значение true, в нижней части окна выбора даты добавляется кнопка для выбора даты текущего дня (начиная с версии 3.7.0). По умолчанию имеет значение true.
  16. weeknumbers - (необязательно): если установлено значение true, то слева от выбора даты добавляется колонка для отображения номера недели в текущем году (начиная с версии 3.7.0). По умолчанию имеет значение true.
  17. filltable - (необязательно): если установлено значение true, даты предыдущего и следующего месяца добавляются сверху и снизу текущего месяца для заполнения сетки (начиная с версии 3.7.0). По умолчанию имеет значение true.
  18. minyear - (необязательно): задать знаковое целое число для ряда лет (-10, -2, 0, 7, 12, ...) для определения относительного нижнего предела для выбора года. Пользователь не может выбрать год до этого предела (начиная с версии 3.7.0). Если ноль, что является значением по умолчанию, то лимит отсутствует.
  19. maxyear - (необязательно): задать знаковое целое число для ряда лет (-10, -2, 0, 7, 12, ...), чтобы определить относительный верхний предел для выбора года. Пользователь не может выбрать год после этого ограничения (начиная с версии 3.7.0). Если ноль, что является значением по умолчанию, то лимит отсутствует.

Пример определения XML-поля легкого DatePicker:

<field 
		name="mycalendar" 
		type="calendar" 
		default="2017-05-15" 
		label="SELECT_A_DATE" 
		description=""
		class="input-small" 
		required="true" 
		filter="user_utc"
		showtime="false" 
		todaybutton="false" 
		filltable="false" 
		translateformat="true" />

Пример расширенного определения XML-поля DatePicker:

<field 
		name="mycalendar" 
		type="calendar" 
		default="2017-05-15" 
		label="SELECT_A_DATE" 
		description=""
		class="input-medium" 
		required="true" 
		filter="user_utc" 
		format="%Y-%m-%d %H:%M:%S"
		singleheader="true" 
		showtime="true" 
		timeformat="12" 
		todaybutton="true" 
		weeknumbers="true"
		filltable="true" 
		minyear="-3" 
		maxyear="5" />

 

<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 - Вычисляет заданное значение времени Гринвича, в соответствии с настройками времени пользователем зоны.