- Introduction to WorkXpress
- Building Your Application
- Examples and Best Practices
- Technical Manual
This shows you the differences between two versions of the page.
expression function - minute [2016/09/14 18:19] |
expression function - minute [2016/09/14 18:19] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Minute (Expression Function) ====== | ||
+ | ===== Purpose ===== | ||
+ | The **Minute** function (MINUTE) generates a number that represents the minute for a timestamp provided in a given timezone. | ||
+ | |||
+ | {{:minute_initial.png?direct&600|}} | ||
+ | |||
+ | ===== Parameters ===== | ||
+ | The **Minute** function has two parameters, one of which is required: | ||
+ | |||
+ | ==== Timestamp ==== | ||
+ | |||
+ | Allowed Inputs: [[Field|field]] value or a number representing a Unix timestamp. | ||
+ | |||
+ | There are several sources of Unix timestamps available. For example the stored value of a [[Field Type - Date|date]] or [[Field Type - Date Time| date time]] field is a Unix timestamp. Also When using the advanced interface the output of the [[Expression Function - Date|date]] or [[Expression Function - Date and Time| date time]] expression function is a Unix timestamp. | ||
+ | |||
+ | ==== Timezone ==== | ||
+ | |||
+ | Allowed Inputs: [[Field|field]] value or a text string | ||
+ | |||
+ | The second optional parameter of the **Minute** function is a string that represents the timezone. Either use the query builder to choose a field that contains the value or use type a value to enter a number. The value should be based on the tz (timezone) database used by Linux and other Unix system in the form “Area/Location” e.g. "America/New_York". If no value is provided then the current user's timezone is used. | ||
+ | |||
+ | ===== Output ===== | ||
+ | |||
+ | The output of the **Minute** function is number representing the minute for the value of the timestamp provided in a given timezone. | ||
+ | ===== Example ===== | ||
+ | |||
+ | For example MINUTE(1349212984,"America/New_York") would result in "23" and MINUTE(1349212984,"America/Caracas") would result in "53". |