dctime

README

dctime

dctime est une librairie Go fournissant des options de parsage de date et d’heure indépendamment du fuseau horaire,

Documentation

Index

• Constants
• func EndOfMonth(year, month int) int
• func EndOfWeek(e time.Weekday) int
• func IsBissextil(year int) bool
• func Now() (d Date, c Clock)
• func NowIn(dd Duration) (d Date, c Clock)
• type Clock
  • func ClockNow() Clock
  • func ClockNowIn(dd Duration) Clock
  • func NewClock(hour, min uint) Clock
  • func ParseClock(in string) (out Clock, ok bool)
  • func (c Clock) Add(d Duration) (r Clock, ok bool)
  • func (c Clock) Clock() (hour, min uint)
  • func (c1 Clock) Compare(c2 Clock) int
  • func (c1 Clock) Diff(c2 Clock) Duration
  • func (c Clock) Format(sep string) string
  • func (c Clock) IsNil() bool
  • func (c Clock) String() string
  • func (c Clock) Sub(d Duration) (Clock, bool)
• type Date
  • func DateNow() Date
  • func DateNowIn(dd Duration) Date
  • func NewDate(year, month, day int) Date
  • func ParseDate(in string) (out Date, ok bool)
  • func (t Date) Add(d Duration) (r Date, ok bool)
  • func (d1 Date) Compare(d2 Date) int
  • func (d Date) Date() (year, month, day int)
  • func (d1 Date) Diff(d2 Date) Duration
  • func (d Date) Eom() Date
  • func (d Date) Eow() Date
  • func (d Date) Format(seps ...string) string
  • func (d Date) IsNil() bool
  • func (d Date) String() string
  • func (t Date) Sub(d Duration) (r Date, ok bool)
• type Duration
  • func NewDuration(v int, u Unit) Duration
  • func ParseDuration(in string) (out Duration, ok bool)
  • func (d Duration) Inv() Duration
  • func (d Duration) IsClock() bool
  • func (d Duration) IsDate() bool
  • func (d Duration) IsNil() bool
  • func (d Duration) String() string
  • func (d Duration) Unit() Unit
  • func (d Duration) Value() int
• type Unit

Constants

const (
	NoUnit Unit = iota
	Minute
	Hour
	Day
	Week
	Month
	Year

	DurationNil Duration = 0
)

Functions

func EndOfMonth

func EndOfMonth(year, month int) int

EndOfMonth retourne le dernier jour du mois

func EndOfWeek

func EndOfWeek(e time.Weekday) int

EndOfWeek retourne le nombre de jours avant la fin de la semaine

func IsBissextil

func IsBissextil(year int) bool

IsBissextil retourne vrai si l’année fournie en paramètre est bissextile

func Now

func Now() (d Date, c Clock)

Now retourne la date et l’heure actuelles

func NowIn

func NowIn(dd Duration) (d Date, c Clock)

NowIn retourne la date et l’heure actuelles incrémentées de la durée spécifiée

Types

type Clock

type Clock uint

Clock représente une heure donnée

const (
	ClockBegin Clock = 0
	ClockEnd   Clock = 60*24 - 1
	ClockNil         = ^ClockBegin
)

func ClockNow

func ClockNow() Clock

ClockNow retourne l’heure actuelle

func ClockNowIn

func ClockNowIn(dd Duration) Clock

func NewClock

func NewClock(hour, min uint) Clock

NewClocek retourne une heure avec le nombre d’heures et de minutes donnés en paramètre

func ParseClock

func ParseClock(in string) (out Clock, ok bool)

ParseClock parse une string en heure. La string doit être sous la forme hhmm ou hh?mm (? étant un caractère)

func (Clock) Add

func (c Clock) Add(d Duration) (r Clock, ok bool)

Add ajoute la durée spécifiée à l’heure

func (Clock) Clock

func (c Clock) Clock() (hour, min uint)

Clock retourne l’heure et la minute

func (Clock) Compare

func (c1 Clock) Compare(c2 Clock) int

Compare retourne 1 si c1 après c2, -1 si c1 avant c2, et 0 sinon.

func (Clock) Diff

func (c1 Clock) Diff(c2 Clock) Duration

Diff retourne la durée entre 2 heures

func (Clock) Format

func (c Clock) Format(sep string) string

Format formate l’heure sous la forme hh<sep>mm

func (Clock) IsNil

func (c Clock) IsNil() bool

IsNil vérifie qu’il s’agit d’une heure valide

func (Clock) String

func (c Clock) String() string

String retourne l’heure sous la forme hh:mm

func (Clock) Sub

func (c Clock) Sub(d Duration) (Clock, bool)

Add soustrait la durée spécifiée à l’heure

type Date

type Date int

Date représente une date

const (
	DateNil Date = 0
)

func DateNow

func DateNow() Date

DateNow retourne la date actuelle

func DateNowIn

func DateNowIn(dd Duration) Date

func NewDate

func NewDate(year, month, day int) Date

NewDate retourne une date avec l’année, le mois et le jour spécifiés

func ParseDate

func ParseDate(in string) (out Date, ok bool)

ParseDate parse une string en date. La string doit être sous la forme YYYYMMJJ ou YYYY?MM?JJ (? étant un caractère)

func (Date) Add

func (t Date) Add(d Duration) (r Date, ok bool)

Add ajoute une durée spécifiée à la date

func (Date) Compare

func (d1 Date) Compare(d2 Date) int

Compare retourne 1 si d1 après d2, -1 si d1 avant d2 et 0 sinon

func (Date) Date

func (d Date) Date() (year, month, day int)

Date retourne l’année, le mois et le jour

func (Date) Diff

func (d1 Date) Diff(d2 Date) Duration

Diff retourne la durée entre deux dates

func (Date) Eom

func (d Date) Eom() Date

Eom retourne la date de fin du mois

func (Date) Eow

func (d Date) Eow() Date

Eow retourne la date de fin de semaine

func (Date) Format

func (d Date) Format(seps ...string) string

Formate retourne la date sous la forme YYY<sep1>MM<sep2>JJ Si un seul séparateur est donné, sep2 = sep1

func (Date) IsNil

func (d Date) IsNil() bool

IsNil retourne vrai si la date est invalide

func (Date) String

func (d Date) String() string

String retourne la date sous la forme YYYY.MM.JJ

func (Date) Sub

func (t Date) Sub(d Duration) (r Date, ok bool)

Sub ajoute une durée spécifiée à la date

type Duration

type Duration int

Duration est une durée entre deux indications de temps

func NewDuration

func NewDuration(v int, u Unit) Duration

NewDuration retourne une durée avec sa valeur et son unité spécifiées

func ParseDuration

func ParseDuration(in string) (out Duration, ok bool)

ParseDuration convertit le paramètre donné en durée. Il doit être sous la forme nU où:

• n est un entier positif ou négatif,
• U l’unité parmi y, m, w, d, H ou M représentant respectivement l’année, le mois, la semaine, le jour, l’heure et la minute

func (Duration) Inv

func (d Duration) Inv() Duration

Inv retourne -d

func (Duration) IsClock

func (d Duration) IsClock() bool

IsClock retourne vrai si la durée a une unité d’heure

func (Duration) IsDate

func (d Duration) IsDate() bool

IsDate retourne vraie si la durée a une unité de date

func (Duration) IsNil

func (d Duration) IsNil() bool

IsNil retourne vrai is la durée n’a pas d’unité

func (Duration) String

func (d Duration) String() string

String retourne la durée sous la forme <valeur><unité>

func (Duration) Unit

func (d Duration) Unit() Unit

Unit retourne l’unité de la durée

func (Duration) Value

func (d Duration) Value() int

Value Retourne la valeur de la durée

type Unit

type Unit int

Unit est une unité de durée