• Joomla
• Формы JForm
• JDate
• XML - Манифест
• config.xml
• Классы
• Тип поля JFormField
• php
• xml
• JFormFieldCalendar

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

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. Ниже приведены некоторые из наиболее часто используемых строк кодов даты:

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

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

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

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

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

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