← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to bzrlib/osutils.py

  • Committer: Martin Pool
  • Date: 2007-04-19 08:03:19 UTC
  • mto: This revision was merged to the branch mainline in revision 2461.
  • Revision ID: mbp@sourcefrog.net-20070419080319-amc7f3frr64lxolq
Make timestamps use existing format_date; document that function more

Show diffs side-by-side

added added

removed removed

Lines of Context:
bzrlib/osutils.py
606
606
    return offset.days * 86400 + offset.seconds
607
607
 
608
608
    
609
 
def format_date(t, offset=0, timezone='original', date_fmt=None, 
 
609
def format_date(t, offset=0, timezone='original', date_fmt=None,
610
610
                show_offset=True):
611
 
    ## TODO: Perhaps a global option to use either universal or local time?
612
 
    ## Or perhaps just let people set $TZ?
613
 
    assert isinstance(t, float)
614
 
    
 
611
    """Return a formatted date string.
 
612
 
 
613
    :param t: Seconds since the epoch.
 
614
    :param offset: Timezone offset in seconds east of utc.
 
615
    :param timezone: How to display the time: 'utc', 'original' for the
 
616
         timezone specified by offset, or 'local' for the process's current
 
617
         timezone.
 
618
    :param show_offset: Whether to append the timezone.
 
619
    :param date_fmt: strftime format.
 
620
    """
615
621
    if timezone == 'utc':
616
622
        tt = time.gmtime(t)
617
623
        offset = 0