README.ko.md

한국어 | English | 简体中文 | 日本語

소개

Carbon 은 가벼우면서도 의미론적이고 개발자 친화적인 golang 시간 처리 라이브러리로, 어떤 서드파티 라이브러리에도 의존하지 않으며, 100% 단위 테스트 커버리지를 가지고 있으며, docker에 공식적으로 사용되고 있고 awesome-go 와 hello-github에도 수록되어 있습니다.

저장소

github.com/dromara/carbon

gitee.com/dromara/carbon

gitcode.com/dromara/carbon

빠른 시작

설치

go version >= 1.18

// GitHub를 통해
go get -u github.com/dromara/carbon/v2
import "github.com/dromara/carbon/v2"

// Gitee를 통해
go get -u gitee.com/dromara/carbon/v2
import "gitee.com/dromara/carbon/v2"

// GitCode를 통해
go get -u gitcode.com/dromara/carbon/v2
import "gitcode.com/dromara/gitcode/v2"

Carbon은 dromara 조직에 기부되었으며, 저장소 URL이 변경되었습니다. 이전에 사용하던 저장소가 golang-module/carbon이었다면, go.mod에서 원래 저장소를 새 저장소로 교체하거나 다음 명령을 실행하세요:

go mod edit -replace github.com/golang-module/carbon/v2 = github.com/dromara/carbon/v2

사용 예시

기본 시간대는 UTC이고, 언어 로케일은 English이며, 주의 시작일은 Monday이고 주말은 Saturday와 Sunday입니다.

carbon.SetTestNow(carbon.Parse("2020-08-05 13:14:15.999999999"))
carbon.IsTestNow() // true

carbon.Now().ToString() // 2020-08-05 13:14:15.999999999 +0000 UTC
carbon.Yesterday().ToString() // 2020-08-04 13:14:15.999999999 +0000 UTC
carbon.Tomorrow().ToString() // 2020-08-06 13:14:15.999999999 +0000 UTC

carbon.Parse("2020-08-05 13:14:15").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.Parse("2022-03-08T03:01:14-07:00").ToString() // 2022-03-08 10:01:14 +0000 UTC

carbon.ParseByLayout("It is 2020-08-05 13:14:15", "It is 2006-01-02 15:04:05").ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.ParseByFormat("It is 2020-08-05 13:14:15", "\\I\\t \\i\\s Y-m-d H:i:s").ToString() // 2020-08-05 13:14:15 +0000 UTC

carbon.CreateFromDate(2020, 8, 5).ToString() // 2020-08-05 00:00:00 +0000 UTC
carbon.CreateFromTime(13, 14, 15).ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.CreateFromDateTime(2020, 8, 5, 13, 14, 15).ToString() // 2020-08-05 13:14:15 +0000 UTC
carbon.CreateFromTimestamp(1596633255).ToString() // 2020-08-05 13:14:15 +0000 UTC

carbon.Parse("2020-07-05 13:14:15").DiffForHumans() // 1 month before
carbon.Parse("2020-07-05 13:14:15").SetLocale("zh-CN").DiffForHumans() // 1 月前

carbon.ClearTestNow()
carbon.IsTestNow() // false

더 많은 사용 예시는 공식 문서를 참조하세요.

성능 테스트 보고서는 벤치마크 보고서를 참조하세요.

참고 자료

• briannesbitt/carbon
• nodatime/nodatime
• jinzhu/now
• goframe/gtime
• jodaOrg/joda-time
• arrow-py/arrow
• moment/moment
• iamkun/dayjs

기여자

Carbon에 기여한 모든 분들께 감사드립니다:

번역자

Carbon 을 더 많은 로컬라이즈드 언어로 번역하는 데 도움을 요청드립니다

Carbon에 새로운 로컬라이즈드 언어 지원을 추가하는 방법

스폰서

Carbon은 비상업적 오픈소스 프로젝트입니다. Carbon을 지원하고 싶으시다면 개발자에게 커피 한 잔을 사주세요.

감사의 말

Carbon은 JetBrains 오픈소스 라이선스의 무료 GoLand로 개발되었습니다. 여기서 감사의 말을 전하고 싶습니다.

라이선스

Carbon은 MIT 라이선스 하에 제공됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.