mirror of
https://github.com/cwinfo/matterbridge.git
synced 2024-11-27 02:01:35 +00:00
45 lines
1.3 KiB
Go
45 lines
1.3 KiB
Go
|
// Copyright 2016 Rick Beton. All rights reserved.
|
||
|
|
// Use of this source code is governed by a BSD-style
|
||
|
|
// license that can be found in the LICENSE file.
|
||
|
|
|
||
|
|
// Package period provides functionality for periods of time using ISO-8601 conventions.
|
||
|
|
// This deals with years, months, weeks/days, hours, minutes and seconds.
|
||
|
|
//
|
||
|
|
// Because of the vagaries of calendar systems, the meaning of year lengths, month lengths
|
||
|
|
// and even day lengths depends on context. So a period is not necessarily a fixed duration
|
||
|
|
// of time in terms of seconds.
|
||
|
|
//
|
||
|
|
// See https://en.wikipedia.org/wiki/ISO_8601#Durations
|
||
|
|
//
|
||
|
|
// Example representations:
|
||
|
|
//
|
||
|
|
// * "P2Y" is two years;
|
||
|
|
//
|
||
|
|
// * "P6M" is six months;
|
||
|
|
//
|
||
|
|
// * "P4D" is four days;
|
||
|
|
//
|
||
|
|
// * "P1W" is one week (seven days);
|
||
|
|
//
|
||
|
|
// * "PT3H" is three hours.
|
||
|
|
//
|
||
|
|
// * "PT20M" is twenty minutes.
|
||
|
|
//
|
||
|
|
// * "PT30S" is thirty seconds.
|
||
|
|
//
|
||
|
|
// These can be combined, for example:
|
||
|
|
//
|
||
|
|
// * "P3Y6M4W1D" is three years, 6 months, 4 weeks and one day.
|
||
|
|
//
|
||
|
|
// * "P2DT12H" is 2 days and 12 hours.
|
||
|
|
//
|
||
|
|
// Also, decimal fractions are supported to one decimal place. To comply with
|
||
|
|
// the standard, only the last non-zero component is allowed to have a fraction.
|
||
|
|
// For example
|
||
|
|
//
|
||
|
|
// * "P2.5Y" is 2.5 years.
|
||
|
|
//
|
||
|
|
// * "PT12M7.5S" is 12 minutes and 7.5 seconds.
|
||
|
|
//
|
||
|
|
package period
|