docs: def _date_bin_set_datetime(new_date):
      '''
      set the system date/time using the date command
  
      Note using a strictly posix-compliant date binary we can only set the date
      up to the minute.
      '''
      cmd = ['date']
  
      # if there is a timezone in the datetime object use that offset
      # This will modify the new_date to be the equivalent time in UTC
      if new_date.utcoffset() is not None:
          new_date = new_date - new_date.utcoffset()
          new_date = new_date.replace(tzinfo=_FixedOffset(0))
          cmd.append('-u')
  
      # the date can be set in the following format:
      # Note that setting the time with a resolution of seconds
      # is not a posix feature, so we will attempt it and if it
      # fails we will try again only using posix features
  
      # date MMDDhhmm[[CC]YY[.ss]]
      non_posix = ("{1:02}{2:02}{3:02}{4:02}{0:04}.{5:02}"
                   .format(*new_date.timetuple()))
      non_posix_cmd = cmd + [non_posix]
  
      ret_non_posix = __salt__['cmd.run_all'](non_posix_cmd, python_shell=False)
      if ret_non_posix['retcode'] != 0:
          # We will now try the command again following posix
          # date MMDDhhmm[[CC]YY]
          posix = " {1:02}{2:02}{3:02}{4:02}{0:04}".format(*new_date.timetuple())
          posix_cmd = cmd + [posix]
  
          ret_posix = __salt__['cmd.run_all'](posix_cmd, python_shell=False)
          if ret_posix['retcode'] != 0:
              # if both fail it's likely an invalid date string
              # so we will give back the error from the first attempt
              msg = 'date failed: {0}'.format(ret_non_posix['stderr'])
              raise CommandExecutionError(msg)
      return True