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

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