DateTime to Calendar Time

Convert DateTime signal to calendar time format

Since R2024b

• 

Description

The DateTime to Calendar Time block converts a DateTime formatted signal to calendar time format.

Limitations

The DateTime blocks are available only as an internal feature with early access. Their design is subject to change.

Ports

Input

Port_1 — DateTime signal

scalar | DateTime

DateTime signal, specified as a scalar.

Output

y — Calendar year

real numeric scalar | integer

Calendar year, returned as a real numeric scalar whose value is an integer.

Dependencies

To enable this parameter, set the Input mode parameter to Calendar time.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

M — Calendar month

real numeric scalar 1 to 12 | integer

Calendar month, returned as a real numeric scalar whose value is an integer between 1 and 12, inclusive.

Dependencies

To enable this parameter, set the Input mode parameter to Calendar time.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

d — Calendar day of month

real numeric scalar 1 to 31 | integer

Calendar day of month, returned as a real numeric scalar whose value is an integer between 1 and 31, inclusive.

Dependencies

To enable this parameter, set the Input mode parameter to Calendar time.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

H — Hour

real numeric scalar 0 to 23 | integer

Hour, returned as a real numeric scalar whose value is an integer between 0 and 23, inclusive.

Dependencies

To enable this parameter, set the Input mode parameter to Calendar time.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

m — Minutes

real numeric scalar 0 to 59 | integer

Minutes, returned as a real numeric scalar whose value is an integer between 0 and 59, inclusive.

Dependencies

To enable this parameter, set the Input mode parameter to Calendar time.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

s — Seconds

real numeric scalar 0 to less than 61.0

Seconds, returned as a real numeric scalar 0 to less than 61.0.

Dependencies

To enable this parameter, set the Input mode parameter to Calendar time.

Data Types: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32

Parameters

To edit block parameters interactively, use the Property Inspector. From the Simulink^® Toolstrip, on the Simulation tab, in the Prepare gallery, select Property Inspector.

Year data type — Year data type

double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Year data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType.

When you select Inherit: Inherit via back propagation, the block uses the data type of the driving block.

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

If the Data type override parameter is set to Off, the Year data type parameter is changed to fixdt('double', 'DataTypeOverride', 'Off').

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	OutYearDataTypeStr
Values:	double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Mode — Year data type mode

Built in (default) | Inherit | Expression

Select the category of data to specify.

• Inherit — Specify a rule for inheriting a data type, for example, Inherit: Inherit via back propagation.

• Built in — Built-in DateTime type. Selecting Built in enables a list to the right where you can select the block output type: double, single, double, int8, uint8, int16, uint16, int32, uint32.

• Expression — Expressions that evaluate to data types. Selecting Expression enables a text box to the right, where you can enter the expression.

For more information, see Specify Data Types Using Data Type Assistant.

Data type override — Year data type override mode

Inherit | Off

Select the data type override mode for this signal.

• When you select Inherit, Simulink inherits the data type override setting from its context, that is, from the block, Simulink.Signal object, or Stateflow^® chart in Simulink that is using the signal.

• When you select Off, Simulink ignores the data type override setting of its context and uses the fixed-point data type specified for the signal.

For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

To enable this parameter, set Mode to Built in or Fixed point.

Tips

The option to turn off data type override for an individual data type provides greater control over the data types in your model when you apply data type override. For example, you can use this option to ensure that data types meet the requirements of downstream blocks regardless of the data type override setting.

Month data type — Month data type

double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Month data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType.

When you select Inherit: Inherit via back propagation, the block uses the data type of the driving block.

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

If the Data type override parameter is set to Off, the Month data type parameter is changed to fixdt('double', 'DataTypeOverride', 'Off').

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	OutMonthDataTypeStr
Values:	double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Mode — Month data type mode

Built in (default) | Inherit | Expression

Select the category of data to specify.

• Inherit — Specify a rule for inheriting a data type, for example, Inherit: Inherit via back propagation.

• Built in — Built-in DateTime type. Selecting Built in enables a list to the right where you can select the block output type: double, single, double, int8, uint8, int16, uint16, int32, uint32.

• Expression — Expressions that evaluate to data types. Selecting Expression enables a text box to the right, where you can enter the expression.

For more information, see Specify Data Types Using Data Type Assistant.

Data type override — Month data type override mode

Inherit | Off

Select the data type override mode for this signal.

• When you select Inherit, Simulink inherits the data type override setting from its context, that is, from the block, Simulink.Signal object, or Stateflow chart in Simulink that is using the signal.

• When you select Off, Simulink ignores the data type override setting of its context and uses the fixed-point data type specified for the signal.

For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

To enable this parameter, set Mode to Built in or Fixed point.

Tips

The option to turn off data type override for an individual data type provides greater control over the data types in your model when you apply data type override. For example, you can use this option to ensure that data types meet the requirements of downstream blocks regardless of the data type override setting.

Day data type — Day data type

double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Day data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType.

When you select Inherit: Inherit via back propagation, the block uses the data type of the driving block.

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

If the Data type override parameter is set to Off, the Day data type parameter is changed to fixdt('double', 'DataTypeOverride', 'Off').

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	OutDayDataTypeStr
Values:	double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Mode — Day data type mode

Built in (default) | Inherit | Expression

Select the category of data to specify.

• Inherit — Specify a rule for inheriting a data type, for example, Inherit: Inherit via back propagation.

• Built in — Built-in DateTime type. Selecting Built in enables a list to the right where you can select the block output type: double, single, double, int8, uint8, int16, uint16, int32, uint32.

• Expression — Expressions that evaluate to data types. Selecting Expression enables a text box to the right, where you can enter the expression.

For more information, see Specify Data Types Using Data Type Assistant.

Data type override — Day data type override mode

Inherit | Off

Select the data type override mode for this signal.

• When you select Inherit, Simulink inherits the data type override setting from its context, that is, from the block, Simulink.Signal object, or Stateflow chart in Simulink that is using the signal.

• When you select Off, Simulink ignores the data type override setting of its context and uses the fixed-point data type specified for the signal.

For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

To enable this parameter, set Mode to Built in or Fixed point.

Tips

The option to turn off data type override for an individual data type provides greater control over the data types in your model when you apply data type override. For example, you can use this option to ensure that data types meet the requirements of downstream blocks regardless of the data type override setting.

Hour data type — Hour data type

double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Hour data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType.

When you select Inherit: Inherit via back propagation, the block uses the data type of the driving block.

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

If the Data type override parameter is set to Off, the Hour data type parameter is changed to fixdt('double', 'DataTypeOverride', 'Off').

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	OutHourDataTypeStr
Values:	double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Mode — Hour data type mode

Built in (default) | Inherit | Expression

Select the category of data to specify.

• Inherit — Specify a rule for inheriting a data type, for example, Inherit: Inherit via back propagation.

• Built in — Built-in DateTime type. Selecting Built in enables a list to the right where you can select the block output type: double, single, double, int8, uint8, int16, uint16, int32, uint32.

• Expression — Expressions that evaluate to data types. Selecting Expression enables a text box to the right, where you can enter the expression.

For more information, see Specify Data Types Using Data Type Assistant.

Data type override — Hour data type override mode

Inherit | Off

Select the data type override mode for this signal.

• When you select Inherit, Simulink inherits the data type override setting from its context, that is, from the block, Simulink.Signal object, or Stateflow chart in Simulink that is using the signal.

• When you select Off, Simulink ignores the data type override setting of its context and uses the fixed-point data type specified for the signal.

For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

To enable this parameter, set Mode to Built in or Fixed point.

Tips

The option to turn off data type override for an individual data type provides greater control over the data types in your model when you apply data type override. For example, you can use this option to ensure that data types meet the requirements of downstream blocks regardless of the data type override setting.

Minute data type — Minute data type

double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Minute data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType.

When you select Inherit: Inherit via back propagation, the block uses the data type of the driving block.

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

If the Data type override parameter is set to Off, the Minute data type parameter is changed to fixdt('double', 'DataTypeOverride', 'Off').

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	OutMinuteDataTypeStr
Values:	double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Mode — Minute data type mode

Built in (default) | Inherit | Expression

Select the category of data to specify.

• Inherit — Specify a rule for inheriting a data type, for example, Inherit: Inherit via back propagation.

• Built in — Built-in DateTime type. Selecting Built in enables a list to the right where you can select the block output type: double, single, double, int8, uint8, int16, uint16, int32, uint32.

• Expression — Expressions that evaluate to data types. Selecting Expression enables a text box to the right, where you can enter the expression.

For more information, see Specify Data Types Using Data Type Assistant.

Data type override — Minute data type override mode

Inherit | Off

Select the data type override mode for this signal.

• When you select Inherit, Simulink inherits the data type override setting from its context, that is, from the block, Simulink.Signal object, or Stateflow chart in Simulink that is using the signal.

• When you select Off, Simulink ignores the data type override setting of its context and uses the fixed-point data type specified for the signal.

For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

To enable this parameter, set Mode to Built in or Fixed point.

Tips

The option to turn off data type override for an individual data type provides greater control over the data types in your model when you apply data type override. For example, you can use this option to ensure that data types meet the requirements of downstream blocks regardless of the data type override setting.

Second data type — Second data type

double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Second data type. The type can be inherited, specified directly, or expressed as a data type object such as Simulink.NumericType.

When you select Inherit: Inherit via back propagation, the block uses the data type of the driving block.

Click the Show data type assistant button to display the Data Type Assistant, which helps you set the data type attributes. For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

If the Data type override parameter is set to Off, the Second data type parameter is changed to fixdt('double', 'DataTypeOverride', 'Off').

Programmatic Use

To set the block parameter value programmatically, use the set_param function.

To get the block parameter value programmatically, use the get_param function.

Parameter:	OutSecondDataTypeStr
Values:	double (default) | Inherit: Inherit via back propagation | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | <data type expression>

Mode — Second data type mode

Built in (default) | Inherit | Expression

Select the category of data to specify.

• Inherit — Specify a rule for inheriting a data type, for example, Inherit: Inherit via back propagation.

• Built in — Built-in DateTime type. Selecting Built in enables a list to the right where you can select the block output type: double, single, double, int8, uint8, int16, uint16, int32, uint32.

• Expression — Expressions that evaluate to data types. Selecting Expression enables a text box to the right, where you can enter the expression.

For more information, see Specify Data Types Using Data Type Assistant.

Data type override — Second data type override mode

Inherit | Off

Select the data type override mode for this signal.

• When you select Inherit, Simulink inherits the data type override setting from its context, that is, from the block, Simulink.Signal object, or Stateflow chart in Simulink that is using the signal.

• When you select Off, Simulink ignores the data type override setting of its context and uses the fixed-point data type specified for the signal.

For more information, see Specify Data Types Using Data Type Assistant.

Dependencies

To enable this parameter, set Mode to Built in or Fixed point.

Tips

The option to turn off data type override for an individual data type provides greater control over the data types in your model when you apply data type override. For example, you can use this option to ensure that data types meet the requirements of downstream blocks regardless of the data type override setting.

Version History

Introduced in R2024b