DateTime
Adds time to date and returns the resulting date.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
date | null | ||
time | null | ||
result_format | timestamp | ||
exclude_millis | False | ||
date_format | None |
Arguments:
date:
Date to add time to in one of the supported date formats.time:
Time that is added in one of the supported time formats.result_format:
Format of the returned date.exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.date_format:
Possible custom timestamp format ofdate
.
Examples:
${date} = | Add Time To Date | 2014-05-28 12:05:03.111 | 7 days |
Should Be Equal | ${date} | 2014-06-04 12:05:03.111 | |
${date} = | Add Time To Date | 2014-05-28 12:05:03.111 | 01:02:03:004 |
Should Be Equal | ${date} | 2014-05-28 13:07:06.115 |
Adds time to another time and returns the resulting time.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
time1 | null | ||
time2 | null | ||
result_format | number | ||
exclude_millis | False |
Arguments:
time1:
First time in one of the supported time formats.time2:
Second time in one of the supported time formats.result_format:
Format of the returned time.exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.
Examples:
${time} = | Add Time To Time | 1 minute | 42 | ||
Should Be Equal | ${time} | ${102} | |||
${time} = | Add Time To Time | 3 hours 5 minutes | 01:02:03 | timer | exclude_millis=yes |
Should Be Equal | ${time} | 04:07:03 |
Converts between supported date formats.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
date | null | ||
result_format | timestamp | ||
exclude_millis | False | ||
date_format | None |
Arguments:
date:
Date in one of the supported date formats.result_format:
Format of the returned date.exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.date_format:
Specifies possible custom timestamp format.
Examples:
${date} = | Convert Date | 20140528 12:05:03.111 | ||
Should Be Equal | ${date} | 2014-05-28 12:05:03.111 | ||
${date} = | Convert Date | ${date} | epoch | |
Should Be Equal | ${date} | ${1401267903.111} | ||
${date} = | Convert Date | 5.28.2014 12:05 | exclude_millis=yes | date_format=%m.%d.%Y %H:%M |
Should Be Equal | ${date} | 2014-05-28 12:05:00 |
Converts between supported time formats.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
time | null | ||
result_format | number | ||
exclude_millis | False |
Arguments:
time:
Time in one of the supported time formats.result_format:
Format of the returned time.exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.
Examples:
${time} = | Convert Time | 10 seconds | ||
Should Be Equal | ${time} | ${10} | ||
${time} = | Convert Time | 1:00:01 | verbose | |
Should Be Equal | ${time} | 1 hour 1 second | ||
${time} = | Convert Time | ${3661.5} | timer | exclude_milles=yes |
Should Be Equal | ${time} | 01:01:02 |
Returns current local or UTC time with an optional increment.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
time_zone | local | ||
increment | 0 | ||
result_format | timestamp | ||
exclude_millis | False |
Arguments:
time_zone:
Get the current time on this time zone. Currently onlylocal
(default) andUTC
are supported.increment:
Optional time increment to add to the returned date in one of the supported time formats. Can be negative.result_format:
Format of the returned date (see date formats).exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.
Examples:
${date} = | Get Current Date | ||
Should Be Equal | ${date} | 2014-06-12 20:00:58.946 | |
${date} = | Get Current Date | UTC | |
Should Be Equal | ${date} | 2014-06-12 17:00:58.946 | |
${date} = | Get Current Date | increment=02:30:00 | |
Should Be Equal | ${date} | 2014-06-12 22:30:58.946 | |
${date} = | Get Current Date | UTC | - 5 hours |
Should Be Equal | ${date} | 2014-06-12 12:00:58.946 | |
${date} = | Get Current Date | result_format=datetime | |
Should Be Equal | ${date.year} | ${2014} | |
Should Be Equal | ${date.month} | ${6} |
Subtracts date from another date and returns time between.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
date1 | null | ||
date2 | null | ||
result_format | number | ||
exclude_millis | False | ||
date1_format | None | ||
date2_format | None |
Arguments:
date1:
Date to subtract another date from in one of the supported date formats.date2:
Date that is subtracted in one of the supported date formats.result_format:
Format of the returned time (see time formats).exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.date1_format:
Possible custom timestamp format ofdate1
.date2_format:
Possible custom timestamp format ofdate2
.
Examples:
${time} = | Subtract Date From Date | 2014-05-28 12:05:52 | 2014-05-28 12:05:10 | |
Should Be Equal | ${time} | ${42} | ||
${time} = | Subtract Date From Date | 2014-05-28 12:05:52 | 2014-05-27 12:05:10 | verbose |
Should Be Equal | ${time} | 1 day 42 seconds |
Subtracts time from date and returns the resulting date.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
date | null | ||
time | null | ||
result_format | timestamp | ||
exclude_millis | False | ||
date_format | None |
Arguments:
date:
Date to subtract time from in one of the supported date formats.time:
Time that is subtracted in one of the supported time formats.result_format:
Format of the returned date.exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.date_format:
Possible custom timestamp format ofdate
.
Examples:
${date} = | Subtract Time From Date | 2014-06-04 12:05:03.111 | 7 days |
Should Be Equal | ${date} | 2014-05-28 12:05:03.111 | |
${date} = | Subtract Time From Date | 2014-05-28 13:07:06.115 | 01:02:03:004 |
Should Be Equal | ${date} | 2014-05-28 12:05:03.111 |
Subtracts time from another time and returns the resulting time.
Arguments
Argument | Type | Default value | Description |
---|---|---|---|
time1 | null | ||
time2 | null | ||
result_format | number | ||
exclude_millis | False |
Arguments:
time1:
Time to subtract another time from in one of the supported time formats.time2:
Time to subtract in one of the supported time formats.result_format:
Format of the returned time.exclude_millis:
When set to any true value, rounds and drops milliseconds as explained in millisecond handling.
Examples:
${time} = | Subtract Time From Time | 00:02:30 | 100 | |
Should Be Equal | ${time} | ${50} | ||
${time} = | Subtract Time From Time | ${time} | 1 minute | compact |
Should Be Equal | ${time} | - 10s |