strftime

package module
v0.0.0-...-2194253 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 26, 2014 License: MIT Imports: 3 Imported by: 2

README

`strftime`_ For Go
==================

Q: Why, we already have `time.Format`_?

A: Yes, but it becomes tricky to use if if you have string with things other
than time in them. (like `/path/to/%Y/%m/%d/report`)


.. _strftime:  http://docs.python.org/2/library/time.html#time.strftime
.. _`time.Format`: http://golang.org/pkg/time/#Time.Format


Installing
==========
::

    go get bitbucket.org/tebeka/strftime

Example
=======
::

    str, err := strftime.Format("%Y/%m/%d", time.Now())


Contact
=======
https://bitbucket.org/tebeka/strftime
    
License
=======
MIT (see `LICENSE.txt`_)

.. _`LICENSE.txt`: https://bitbucket.org/tebeka/strftime/src/tip/LICENSE.txt

Documentation

Overview

Implementation of Python's strftime in Go

Example:

str, err := strftime.Format("%Y/%m/%d", time.Now()) // 2012/12/07

Directives:

%a - Locale’s abbreviated weekday name
%A - Locale’s full weekday name
%b - Locale’s abbreviated month name
%B - Locale’s full month name
%c - Locale’s appropriate date and time representation
%d - Day of the month as a decimal number [01,31]
%H - Hour (24-hour clock) as a decimal number [00,23]
%I - Hour (12-hour clock) as a decimal number [01,12]
%j - Day of year
%m - Month as a decimal number [01,12]
%M - Minute as a decimal number [00,59]
%p - Locale’s equivalent of either AM or PM
%S - Second as a decimal number [00,61]
%U - Week number of the year
%w - Weekday as a decimal number
%W - Week number of the year
%x - Locale’s appropriate date representation
%X - Locale’s appropriate time representation
%y - Year without century as a decimal number [00,99]
%Y - Year with century as a decimal number
%Z - Time zone name (no characters if no time zone exists)

Note that %c returns RFC1123 which is a bit different from what Python does

Index

Constants

View Source
const (
	Version = "0.1.1"

	WEEK = time.Hour * 24 * 7
)

Variables

This section is empty.

Functions

func Format

func Format(format string, t time.Time) (result string, err error)

Format return string with % directives expanded. Will return error on unknown directive.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL