Документация для разработчиков
Темная тема

GetDateFilter

Описание и параметры

string
CForm::GetDateFilter(
	int filter_sid,
	string html_form_name = "form1",
	string show_dropdown = "Y",
	string add_to_dropdown = "class=\"inputselect\"",
	string add_to_text = "class=\"inputtext\""
)

Возвращает HTML код поля фильтра, предназначенного для фильтрации результатов по датам, введенным в качестве ответа на вопрос веб-формы, либо значений полей веб-формы типа "дата". Возвращаемый HTML код включает в себя два поля, предназначенных для ввода интервала дат, а также некоторые вспомогательные элементы (календарь, выпадающий список дней). Метод нестатический.

Примечание
Имена результирующих HTML полей будут сформированы по следующим маскам:
find_filter_sid_1 - первое поля интервала дат (с)
find_filter_sid_2 - второе поле интервала дат (по)

Параметры метода

Параметр Описание С версии
filter_sid Идентификатор поля фильтра. Формируется по следующему шаблону:
FSID_QSID_USER_date,
где: Примеры:
  • ANKETA_USER_BIRTHDAY_USER_date
  • ANKETA_DATE_FIELD_USER_date
html_form_name Имя HTML формы, в которой выводится фильтр.
<form name="html_form_name" ...>

Параметр необязательный. По умолчанию - "form1".
show_dropdown Если значение "Y", то возвращаемый HTML код будет включать выпадающий список дней, предназначенный для облегчения выбора даты.

Параметр необязательный. По умолчанию - "Y" (вывести выпадающий список дней).
add_to_dropdown Если show_dropdown="Y", то в данном параметре можно указать произвольный HTML, который будет добавлен в тег выпадающего списка дней:
<select add_to_dropdown ...>

Параметр необязательный. По умолчанию - "class=\"inputselect\"".
add_to_text Произвольный HTML, который будет добавлен в теги однострочных текстовых полей, предназначенных для ввода даты:
<input type="text" add_to_text ...>

Параметр необязательный. По умолчанию - "class=\"inputtext\"".
field_select Необязательный параметр. 3.3.0
field_input Необязательный параметр. Изменен с 4.0.4 3.3.0

Примеры использования

<form name="form1" action="" method="POST">
<table>
	<tr>
		<td>Дата рождения:</td>
		<td><?
			echo CForm::GetDateFilter(
				"ANKETA_USER_BIRTHDAY_USER_date", 
				"form1", 
				"Y", 
				"class=\"inputselect\"", 
				"class=\"inputtext\""
			);
		?></td>
	</tr>
</table>
<input type="submit" value="Фильтр">
</form>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх