> For the complete documentation index, see [llms.txt](https://wfsys.gitbook.io/workflow-forms-syntax/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wfsys.gitbook.io/workflow-forms-syntax/workflow_forms/objects/date_time_picker.md).

# DateTimePicker

## Шаблон DateTimePicker <a href="#template" id="template"></a>

Перечень всех возможных тэгов объекта:

```xml
<MyObject Name="" Type="DateTimePicker" Assembly="BaseControls" ChangeForm="">
  <!--Тэги, общие для всех графических объектов-->
  <Top></Top>
  <Bottom></Bottom>
  <Left></Left>
  <Right></Right>
  <Height></Height>
  <Width></Width>
  <FontStyle></FontStyle>
  <ForeColor></ForeColor>
  <BackColor></BackColor>
  <Enabled></Enabled>
  <Visible></Visible>
  <Hint></Hint>
  <ContextMenu Name="" />
  <Change User="" Source="" ValueSet="" />
  <!--Тэги, специфичные для DateTimePicker-->
  <Format></Format>  
  <ShowCalendar></ShowCalendar> 
  <NullValue Show="" />
  <Value></Value>
</MyObject>
```

## Описание DateTimePicker <a href="#description" id="description"></a>

```xml
<MyObject Name="DateTimePickerName" Type="DateTimePicker" Assembly="BaseControls">
  <!--Тэги, общие для всех графических объектов-->
  <!--Тэги, специфичные для DateTimePicker-->
</MyObject>
```

### Получение значения <a href="#get-value" id="get-value"></a>

Значением DateTimePicker считается значение даты, указанной в поле.

В зависимости от формата даты значение DateTimePicker может быть разных типов:

1. Если в формате задана только дата, то значение DateTimePicker будет типа Date.
2. Если в формате задано только время, то значение DateTimePicker будет типа TimeSpan.
3. Если в формате задана и дата, и время, то значение DateTimePicker будет типа DateTime.

```xml
<Object Name="DateTimePickerName" />
```

### Задание значения <a href="#set-value" id="set-value"></a>

Ожидается значение типа дата/время.

```xml
<Object Name="DateTimePickerName"></Object>
```

## Тэги, специфичные для DateTimePicker <a href="#specific-tags" id="specific-tags"></a>

### Format <a href="#format" id="format"></a>

Формат даты.

Необязательный тэг. Любое значение будет переведено в текстовое.

По умолчанию используется значение "dd MMMM yyyy г.".

```xml
<Format>dd MМMM yyyy</Format>
```

### ShowCalendar <a href="#show_calendar" id="show_calendar"></a>

Признак, определяющий, будет ли показан календарь.

Необязательный тэг. Ожидается логическое значение.

По умолчанию используется значение True.

```xml
<ShowCalendar>True</ShowCalendar>
```

### NullValue <a href="#null_value" id="null_value"></a>

Настройка отображения NULL-значения объекта.

Необязательный тэг. Значение тэга `<NullValue>`: не ожидается.

Если тэг `<NullValue>` отсутствует, то для атрибута `Show` используется значение True.

```xml
<NullValue Show="True" />
```

#### Атрибуты тэга `<NullValue>` <a href="#attributes_tag_null_value" id="attributes_tag_null_value"></a>

<table data-header-hidden><thead><tr><th></th><th width="435.6666666666667"></th></tr></thead><tbody><tr><td>Show</td><td><p>Признак, определяющий, может ли дата иметь значение NULL.</p><p></p><p>Необязательный атрибут. Ожидается логическое значение.</p></td></tr></tbody></table>

### MinDate <a href="#min_date" id="min_date"></a>

Признак, определяющий минимальное значение даты и времени, которые могут быть выбраны в поле.

Необязательный тэг. Ожидается значения типа дата/время.

По умолчанию используется минимально возможное значение даты.

```xml
<MinDate>1900-01-01</MinDate>
```

### MaxDate <a href="#max_date" id="max_date"></a>

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

Необязательный тэг. Ожидается значения типа дата/время.

По умолчанию используется максимально возможное значение даты.

```xml
<MaxDate>2100-01-01</MaxDate>
```

### Value <a href="#value" id="value"></a>

Значение поля.

Необязательный тэг. Ожидается значения типа дата/время.

```xml
<Value>2012-05-10</Value>
```

## Get-проперти для получения свойств <a href="#get-properties" id="get-properties"></a>

### Format <a href="#get_format" id="get_format"></a>

Возвращает формат даты в поле.&#x20;

```xml
<Object Name="DateTimePickerName">
  <Property Name="Format" />
</Object>
```

### ShowCalendar <a href="#get_show_calendar" id="get_show_calendar"></a>

Возвращает признак, определяющий, будет ли показан календарь.&#x20;

```xml
<Object Name="DateTimePickerName">
  <Property Name="ShowCalendar" />
</Object>
```

### DayOfWeek <a href="#get_day_of_week" id="get_day_of_week"></a>

Возвращает день недели даты, указанной в контроле, в виде числа от 0 до 6.

```xml
<Object Name="DateTimePickerName">
  <Property Name="DayOfWeek" />
</Object>
```

### MinDate <a href="#get_min_date" id="get_min_date"></a>

Возвращает минимальное значение даты.

```xml
<Object Name="DateTimePickerName">
  <Property Name="MinDate" />
</Object>
```

### MaxDate <a href="#get_max_date" id="get_max_date"></a>

Возвращает максимальное значение даты.

```xml
<Object Name="DateTimePickerName">
  <Property Name="MaxDate" />
</Object>
```

## Set-проперти для динамического задания свойств <a href="#set-properties" id="set-properties"></a>

### Format <a href="#set_format" id="set_format"></a>

Задает формат даты поля.

Любое значение будет переведено в текстовое.

```xml
<Object Name="DateTimePickerName">
  <Property Name="Format">dd.MM.yyyy HH:mm</Property>
</Object>
```

### ShowCalendar <a href="#set_show_calendar" id="set_show_calendar"></a>

Задает признак, определяющий, будет ли показан календарь.

Ожидается логическое значение.

```xml
<Object Name="DateTimePickerName">
  <Property Name="ShowCalendar">False</Property>
</Object>
```

### MinDate <a href="#set_min_date" id="set_min_date"></a>

Задает минимальное значение даты.

```xml
<Object Name="DateTimePickerName">
  <Property Name="MinDate">1900-01-01</Property>
</Object>
```

### MaxDate <a href="#set_max_date" id="set_max_date"></a>

Задает максимальное значение даты.

```xml
<Object Name="DateTimePickerName">
  <Property Name="MaxDate">2100-01-01</Property>
</Object>
```
