julian

README

Julian Day/Modified Julian Day

English | 简体中文 | 日本語

Usage and example

Convert Gregorian calendar to Julian Day

// By default, 6 decimal places are retained for precision
carbon.Parse("2024-01-24 12:00:00").Julian().JD() // 2460334
carbon.Parse("2024-01-24 13:14:15").Julian().JD() // 2460334.051563

// 4 decimal places are retained for precision
carbon.Parse("2024-01-24 12:00:00").Julian().JD(4) // 2460334
carbon.Parse("2024-01-24 13:14:15").Julian().JD(4) // 2460334.0516

Convert Gregorian calendar to Modified Julian Day

// By default, 6 decimal places are retained for precision
carbon.Parse("2024-01-24 12:00:00").Julian().MJD() // 60333.5
carbon.Parse("2024-01-24 13:14:15").Julian().MJD() // 60333.551563

// 4 decimal places are retained for precision
carbon.Parse("2024-01-24 12:00:00").Julian().MJD(4) // 60333.5
carbon.Parse("2024-01-24 13:14:15").Julian().MJD(4) // 60333.5516

Convert Julian Day to Modified Julian Day

// By default, 6 decimal places are retained for precision
carbon.CreateFromJulian(2460334).Julian().MJD() // 60333.5
carbon.CreateFromJulian(2460334.051563).Julian().MJD() // 60332.551563

// 4 decimal places are retained for precision
carbon.CreateFromJulian(2460334).Julian().MJD(4) // 60333.5
carbon.CreateFromJulian(2460334.051563).Julian().MJD(4) // 60332.5516

Convert Modified Julian Day to Julian Day

// By default, 6 decimal places are retained for precision
carbon.CreateFromJulian(60333.5).Julian().JD()() // 2460334
carbon.CreateFromJulian(60333.551563).Julian().JD()() // 2460333.051563

// 4 decimal places are retained for precision
carbon.CreateFromJulian(60333.5).Julian().JD(4) // 2460334
carbon.CreateFromJulian(60333.551563).Julian().JD(4) // 2460333.0516

Convert Julian Day/Modified Julian Day to Gregorian calendar

// Convert Julian Day to Gregorian calendar
carbon.CreateFromJulian(2460334).ToDateTimeString() // 2024-01-24 12:00:00
carbon.CreateFromJulian(2460334.051563).ToDateTimeString() // 2024-01-24 13:14:15

// Convert Modified Julian Day to Gregorian calendar
carbon.CreateFromJulian(60333.5).ToDateTimeString() // 2024-01-24 12:00:00
carbon.CreateFromJulian(60333.551563).ToDateTimeString() // 2024-01-24 13:14:15

Documentation

Overview

Package julian is part of the carbon package.

Index

• type Gregorian
  • func FromGregorian(t time.Time) (g Gregorian)
  • func (g Gregorian) ToJulian() (j Julian)
• type Julian
  • func FromJulian(f float64) (j Julian)
  • func (j Julian) IsZero() bool
  • func (j Julian) JD(precision ...int) float64
  • func (j Julian) MJD(precision ...int) float64
  • func (j Julian) ToGregorian() (g Gregorian)

Types

type Gregorian

type Gregorian struct {
	calendar.Gregorian
}

Gregorian defines a Gregorian struct. 定义 Gregorian 结构体

func FromGregorian

func FromGregorian(t time.Time) (g Gregorian)

FromGregorian creates a Gregorian instance from time.Time. 从标准 time.Time 创建 Gregorian 实例

func (Gregorian) ToJulian

func (g Gregorian) ToJulian() (j Julian)

ToJulian converts Gregorian instance to Julian instance. 将 Gregorian 实例转化为 Julian 实例

type Julian

type Julian struct {
	// contains filtered or unexported fields
}

Julian defines a Julian struct. 定义 Julian 结构体

func FromJulian

func FromJulian(f float64) (j Julian)

FromJulian creates a Julian instance from julian day or modified julian day. 从 儒略日 或 简化儒略日 创建 Julian 实例

func (Julian) IsZero

func (j Julian) IsZero() bool

IsZero reports whether is zero time. 是否是零值时间

func (Julian) JD

func (j Julian) JD(precision ...int) float64

JD gets julian day like 2460332.5 获取儒略日

func (Julian) MJD

func (j Julian) MJD(precision ...int) float64

MJD gets modified julian day like 60332 获取简化儒略日

func (Julian) ToGregorian

func (j Julian) ToGregorian() (g Gregorian)

ToGregorian converts Julian instance to Gregorian instance. 将 Julian 实例转化为 Gregorian 实例