RobotFramework之DateTime

时间 2019-11-13

标签 robotframework datetime 繁體版

原文原文链接

RobotFramework之DateTime

背景

继续学习RobotFramework框架，此次看的是DateTime库。html

DateTime库是RobotFramework操做时间的一个库，能够进行不少时间方面的操做。框架

DateTime is a Robot Framework standard library that supports creating and converting date and time values (e.g. Get Current Date, Convert Time), as well as doing simple calculations with them (e.g. Subtract Time From Date, Add Time To Time). It supports dates and times in various formats, and can also be used by other libraries programmatically.学习

Get Current Date

示例代码ui

*** Settings ***
Library     DateTime

*** Test Cases ***
test1
    ${tm}       get_current_date
    log     ${tm

执行结果spa

11:08:49.158    INFO    2017-05-01 11:08:49.157

源代码code

def get_current_date(time_zone='local', increment=0,
                     result_format='timestamp', exclude_millis=False):
    if time_zone.upper() == 'LOCAL':
        dt = datetime.now()
    elif time_zone.upper() == 'UTC':
        dt = datetime.utcnow()
    else:
        raise ValueError("Unsupported timezone '%s'." % time_zone)
    date = Date(dt) + Time(increment)
    return date.convert(result_format, millis=is_falsy(exclude_millis))

说明orm

这个方法能够不传入参数，默认使用的是当地时间，若是第一个参数传入utc不区分大小写，则会使用utc时间。若是须要一个时间偏移量，则能够在第二个参数中传入时间偏移，传入的参数能够是一个数字或者str的数字，单位为秒，好比以下代码，执行的结果就会相差1分钟htm

test1
    ${tmdl}       get_current_date    local       60
    ${tm}       get_current_date
    log     ${tm}
    log     ${tmdl}
    
Result

KEYWORD BuiltIn . Log ${tm}
Documentation:  
Logs the given message with the given level.
Start / End / Elapsed:  20170501 11:22:13.600 / 20170501 11:22:13.600 / 00:00:00.000
11:22:13.600    INFO    2017-05-01 11:22:13.600 
00:00:00.001KEYWORD BuiltIn . Log ${tmdl}
Documentation:  
Logs the given message with the given level.
Start / End / Elapsed:  20170501 11:22:13.600 / 20170501 11:22:13.601 / 00:00:00.001
11:22:13.601    INFO    2017-05-01 11:23:13.599

固然，也能够传入一个timedelta,会经过以下代码解析成秒数进行处理。rem

class Time(object):

    def __init__(self, time):
        self.seconds = float(self._convert_time_to_seconds(time))

    def _convert_time_to_seconds(self, time):
        if isinstance(time, timedelta):
            # timedelta.total_seconds() is new in Python 2.7
            return (time.days * 24 * 60 * 60 +
                    time.seconds +
                    time.microseconds / 1e6)
        return timestr_to_secs(time, round_to=None)

第三个参数为格式化参数，从代码中能够看到，默认传入的是timestamp，而这里的解析源代码以下get

def convert(self, format, millis=True):
        dt = self.datetime
        if not millis:
            secs = 1 if dt.microsecond >= 5e5 else 0
            dt = dt.replace(microsecond=0) + timedelta(seconds=secs)
        if '%' in format:
            return self._convert_to_custom_timestamp(dt, format)
        format = format.lower()
        if format == 'timestamp':
            return self._convert_to_timestamp(dt, millis)
        if format == 'datetime':
            return dt
        if format == 'epoch':
            return self._convert_to_epoch(dt)
        raise ValueError("Unknown format '%s'." % format)

因此，能够传入timestamp、datetime、epoch或者是咱们正常格式化时间的%Y%m%d

第四个参数传入的是布尔值，是否须要毫秒级的数据，默认是False，也就是有毫秒的，若是不须要的话，传入${true}便可

Convert Date

示例代码

*** Settings ***
Library     DateTime

*** Test Cases ***
test1
    ${tm}       convert_date        20170501
    log     ${tm}

执行结果

11:58:27.558    INFO    2017-05-01 00:00:00.000

源代码

def convert_date(date, result_format='timestamp', exclude_millis=False,
                 date_format=None):
    return Date(date, date_format).convert(result_format,
                                           millis=is_falsy(exclude_millis))
                                           
def convert(self, format, millis=True):
        dt = self.datetime
        if not millis:
            secs = 1 if dt.microsecond >= 5e5 else 0
            dt = dt.replace(microsecond=0) + timedelta(seconds=secs)
        if '%' in format:
            return self._convert_to_custom_timestamp(dt, format)
        format = format.lower()
        if format == 'timestamp':
            return self._convert_to_timestamp(dt, millis)
        if format == 'datetime':
            return dt
        if format == 'epoch':
            return self._convert_to_epoch(dt)
        raise ValueError("Unknown format '%s'." % format)

说明

该方法就是一个时间格式转换的方法，在上一个方法Get Current Date中获取的结果若是须要其余格式，就能够用这个方法进行转换，参数传入与上一个方法同样。

Convert Time

示例代码

*** Settings ***
Library     DateTime

*** Test Cases ***
test1
    ${tm}       convert_time    10      timedelta
    log     ${tm}

执行结果

12:06:08.990    INFO    0:00:10

源代码

def convert_time(time, result_format='number', exclude_millis=False):
    return Time(time).convert(result_format, millis=is_falsy(exclude_millis))
    
class Time(object):

    def __init__(self, time):
        self.seconds = float(self._convert_time_to_seconds(time))
    
    def convert(self, format, millis=True):
        try:
            result_converter = getattr(self, '_convert_to_%s' % format.lower())
        except AttributeError:
            raise ValueError("Unknown format '%s'." % format)
        seconds = self.seconds if millis else float(roundup(self.seconds))
        return result_converter(seconds, millis)

    def _convert_to_number(self, seconds, millis=True):
        return seconds

    def _convert_to_verbose(self, seconds, millis=True):
        return secs_to_timestr(seconds)

    def _convert_to_compact(self, seconds, millis=True):
        return secs_to_timestr(seconds, compact=True)

    def _convert_to_timer(self, seconds, millis=True):
        return elapsed_time_to_string(seconds * 1000, include_millis=millis)

    def _convert_to_timedelta(self, seconds, millis=True):
        return timedelta(seconds=seconds)

说明

第一个参数是必传的，会在初始化Time类的时候转换成秒。源代码中的convert用了一个反射的方法，因此默认调用的是_convert_to_number会直接把传入的第一个参数转换成秒，而后返回。我写的示例代码填的是timedelta，会转换成时间格式。

Subtract Date From Date

示例代码

test
    ${time}     Subtract Date From Date         2014-05-28 12:05:52     2014-05-28 12:05:10
    log     ${time}

执行结果

INFO    42.0

源代码

def subtract_date_from_date(date1, date2, result_format='number',
                            exclude_millis=False, date1_format=None,
                            date2_format=None):
    time = Date(date1, date1_format) - Date(date2, date2_format)
    return time.convert(result_format, millis=is_falsy(exclude_millis))
    
class Date(object):

    def __init__(self, date, input_format=None):
        self.seconds = self._convert_date_to_seconds(date, input_format)
        
    def _convert_date_to_seconds(self, date, input_format):
        if is_string(date):
            return self._string_to_epoch(date, input_format)
        elif isinstance(date, datetime):
            return self._mktime_with_millis(date)
        elif is_number(date):
            return float(date)
        raise ValueError("Unsupported input '%s'." % date)

说明

方法是获取两个日期之间的差值，最终结果单位是秒，从示例代码中能够看得出来。Date类会将传入的date1和date2转换成默认的格式，而后作一次减法。最后获得的日期结果，经过time.convert方法转成秒

Add Time To Date

示例代码

test
    ${time}     add time to date    2014-05-28 12:05:03.111     7 days
    log     ${time}

执行结果

INFO    2014-06-04 12:05:03.111

示例代码

def add_time_to_date(date, time, result_format='timestamp',
                     exclude_millis=False, date_format=None):
    date = Date(date, date_format) + Time(time)
    return date.convert(result_format, millis=is_falsy(exclude_millis))

说明

传入的参数7 days表示7天，这里的时间类型用的是timedelta类，支持如下的单位days, seconds, minutes, hours，若是不传，默认是seconds

Subtract Time From Date

示例代码

test
    ${time}     subtract time from date    2014-05-28 12:05:03.111     7 days
    log     ${time}

执行结果

INFO    2014-05-21 12:05:03.111

源代码

def subtract_time_from_date(date, time, result_format='timestamp',
                            exclude_millis=False, date_format=None):
    date = Date(date, date_format) - Time(time)
    return date.convert(result_format, millis=is_falsy(exclude_millis))

Add Time To Time

示例代码

test
    ${time}     add time to time    1 days     7 days
    log     ${time}

执行结果

INFO    691200.0

源代码

def add_time_to_time(time1, time2, result_format='number',
                     exclude_millis=False):
    time = Time(time1) + Time(time2)
    return time.convert(result_format, millis=is_falsy(exclude_millis))

Subtract Time From Time

示例代码

test
    ${time}     subtract time from time    1 days     7 days
    log     ${time}

执行结果

INFO    -518400.0

源代码

def subtract_time_from_time(time1, time2, result_format='number',
                            exclude_millis=False):
    time = Time(time1) - Time(time2)
    return time.convert(result_format, millis=is_falsy(exclude_millis))

总结

DateTime库主要的操做方式就只有Date和Time这两个类，只要搞懂这两个类的处理逻辑，就能理解DateTime这个库的操做方式