# cf.dt

`cf.``dt`(*args, **kwargs)

  Return a date-time variable for a given date and time.

  The date and time may be specified with an ISO 8601-like date-time string (in which non-Gregorian calendar dates are allowed) or by providing a value for the year and, optionally, the month, day, hour, minute, second and microsecond.

  See also

  `cf.Datetime`

  Parameters: | args, kwargs: If the first positional argument is a string, then it must be an ISO 8601-like date-time string from which a `cf.Datetime` object is initialized. Otherwise, the positional and keyword arguments are used to explicitly initialize a `cf.Datetime` object, so see `cf.Datetime` for details.
  Returns: | out: `cf.Datetime` The new date-time object.
  Examples: |

      >>> d = cf.dt(2003)
      >>> print d
      '2003-2-30T00:00:00Z'
      >>> d = cf.dt(2003, 2, 30)
      >>> d = cf.dt(2003, 2, 30, 0, 0, 0)
      >>> d = cf.dt('2003-2-30')
      >>> d = cf.dt('2003-2-30 0:0:0')

      >>> d = cf.dt(2003, 4, 5, 12, 30, 15)
      >>> d = cf.dt(year=2003, month=4, day=5, hour=12, minute=30, second=15)
      >>> d = cf.dt('2003-04-05 12:30:15')
      >>> d.year, d.month, d.day, d.hour, d.minute, d.second
      (2003, 4, 5, 12, 30, 15)