Hour (FPScript)


Determines the hour of the day of one or more calendar time or time span values.


Hour(Time, Timezone)


The syntax of the Hour function consists of the following parts:




The calendar time or time span value from which the hour is to be extracted.

Permitted data structures are scalar value, data series und data matrix. All real data types are permitted.

If the argument is a list, then the function is executed for each element of the list and the result is also a list.


Is the timezone for which the result should be determined, as a time offset from Coordinated Universal Time (UTC) in hours. If you omit the argument, the result will be determined in local time. If you have specified a time span value as the Time argument, then the Timezone argument will be ignored.

Permitted data structures are scalar value. Supported data types are 16-bit integer, 32-bit integer, 64-bit integer, 32-bit floating point, 64-bit floating point und time span.

If the argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.


The data type of the result is always 64-bit floating point.

The structure of the result corresponds to that of the argument Time. The calculation is done element-by-element where appropriate.

The result has the unit h.

If the argument does not represent a valid calendar time, then a void floating point value is output.

Available in

FlexPro View, Basic, Professional, Developer Suite


Hour('2/9/04 12:30:00')

Results in 12.


Results in -12.

Hour(1.25 d)

Results in 6. A real value with a time unit is interpreted as a time span.


Results in ?. A numerical value without a unit is interpreted as a calendar time.

See Also

Second Function

Minute Function

Day Function

Month Function

Year Function

WeekDay Function

DayOfYear Function

Date Function

Time Function

Share article or send as email:

You might be interested in these articles