web2py.gluon.validators.IS_TIME

Package web2py :: Package gluon :: Module validators :: Class IS_TIME |
[hide private]
[frames] | no frames]

# Class IS_TIME

source code

    object --+
             |
     Validator --+
                 |
                IS_TIME

example:

       INPUT(_type='text', _name='name', requires=IS_TIME())

understands the following formats hh:mm:ss [am/pm] hh:mm [am/pm] hh [am/pm]

[am/pm] is optional, ':' can be replaced by any other non-space non-digit

    >>> IS_TIME()('21:30')
    (datetime.time(21, 30), None)
    >>> IS_TIME()('21-30')
    (datetime.time(21, 30), None)
    >>> IS_TIME()('21.30')
    (datetime.time(21, 30), None)
    >>> IS_TIME()('21:30:59')
    (datetime.time(21, 30, 59), None)
    >>> IS_TIME()('5:30')
    (datetime.time(5, 30), None)
    >>> IS_TIME()('5:30 am')
    (datetime.time(5, 30), None)
    >>> IS_TIME()('5:30 pm')
    (datetime.time(17, 30), None)
    >>> IS_TIME()('5:30 whatever')
    ('5:30 whatever', 'enter time as hh:mm:ss (seconds, am, pm optional)')
    >>> IS_TIME()('5:30 20')
    ('5:30 20', 'enter time as hh:mm:ss (seconds, am, pm optional)')
    >>> IS_TIME()('24:30')
    ('24:30', 'enter time as hh:mm:ss (seconds, am, pm optional)')
    >>> IS_TIME()('21:60')
    ('21:60', 'enter time as hh:mm:ss (seconds, am, pm optional)')
    >>> IS_TIME()('21:30::')
    ('21:30::', 'enter time as hh:mm:ss (seconds, am, pm optional)')
    >>> IS_TIME()('')
    ('', 'enter time as hh:mm:ss (seconds, am, pm optional)')

Instance Methods | [hide private]
__init__(self, error_message=`'``enter time as hh:mm:ss (seconds, am, pm optional)``'`) x.__init__(...) initializes x; see x.__class__.__doc__ for signature | source code
__call__(self, value) | source code
Inherited from `Validator`: `formatter` Inherited from `object`: `__delattr__`, `__getattribute__`, `__hash__`, `__new__`, `__reduce__`, `__reduce_ex__`, `__repr__`, `__setattr__`, `__str__`

Properties | [hide private]
Inherited from `object`: `__class__`

Method Details | [hide private]

### __init__(self, error_message=`'``enter time as hh:mm:ss (seconds, am, pm optional)``'`) (Constructor) | source code
x.__init__(...) initializes x; see x.__class__.__doc__ for signature Overrides: object.__init__ (inherited documentation)