Moment.net ⏰

Overview 📌

This library aims to port as many bits of functionality from moment.js as necessary. Currently supported features include: FromNow, From, ToNow, To, StartOf, EndOf, and CalendarTime. Additional functionalities not present in moment.js are also being added.

Getting Started 🚀

Install Moment.net via NuGet:

Package Manager 📦

PM > Install-Package moment.net

.NET CLI 💻

> dotnet add package moment.net

PackageReference 📝

<PackageReference Include="moment.net" />

Example Usage 🛠️

FromNow ⏳

var dateTime = new DateTime(2017, 1, 1); var relativeTime = dateTime.FromNow(); // 2 years ago

From ⏪

var past = new DateTime(2017, 1, 1); var future = new DateTime(2020, 1, 1); var relativeTime = past.From(future); // 3 years ago

ToNow ⏩

var dateTime = new DateTime(2020, 1, 1); var relativeTime = dateTime.ToNow(); // in one year

To 🎯

var past = new DateTime(2019, 1, 1); var future = new DateTime(2021, 1, 1); var relativeTime = past.To(future); // in 2 years

StartOf 🏁

var date = DateTime.Parse("5/1/2008 8:30:52 AM", System.Globalization.CultureInfo.InvariantCulture); var startOfDay = date.StartOf(DateTimeAnchor.Day); // 01/05/2008 00:00:00

EndOf 🔚

var date = DateTime.Parse("5/1/2008 8:30:52 AM", System.Globalization.CultureInfo.InvariantCulture); var endOfDay = date.EndOf(DateTimeAnchor.Day); // 01/05/2008 23:59:59

CalendarTime 📅

var startDateTime = new DateTime(2012, 12, 12); var sameDay = new DateTime(2012, 12, 12, 12, 0, 0); var calendarTime = startDateTime.CalendarTime(sameDay); // Today at 12:00 PM

UnixTime ⌛

var dateTime = new DateTime(1971, 01, 01, 0, 0, 0, DateTimeKind.Utc); var millisecondsElapsed = dateTime.UnixTimestampInMilliseconds(); // 31536000000

First and Last Date in a Week 📆

date.FirstDateInWeek(); // 27/04/2008 00:00:00 (previous month) date.LastDateInWeek(); // 03/05/2008 00:00:00

Next 🔜

var date = DateTime.Parse("5/1/2008 8:30:52 AM", System.Globalization.CultureInfo.InvariantCulture); date.Next(DayOfWeek.Thursday); // 08/05/2008 08:30:52

Last 🔙

var date = DateTime.Parse("5/1/2008 8:30:52 AM", System.Globalization.CultureInfo.InvariantCulture); date.Last(DayOfWeek.Friday); // 25/04/2008 08:30:52

Final 📍

var date = DateTime.Parse("5/1/2008 8:30:52 AM", System.Globalization.CultureInfo.InvariantCulture); date.Final().Monday().InMonth(); // 26/05/2008 00:00:00

Format 🖋️

var dateTime = new DateTime(1971, 01, 01, 0, 0, 0, DateTimeKind.Utc); date.Format("yyyy MMM dd"); // 1971 Jan 01

IsLeapYear 🏅

var dateTime = DateTime.Parse("1992-02-01"); dateTime.IsLeapYear(); // True

IsBusinessDay 💼

var dateTime = DateTime.Parse("2023-10-20"); dateTime.IsBusinessDay(); // True (Friday)

IsWeekend 🏖️

var dateTime = DateTime.Parse("2023-10-21"); dateTime.IsWeekend(); // True (Saturday)

IsWeekday 🏢

var dateTime = DateTime.Parse("2023-10-23"); dateTime.IsWeekday(); // True (Monday)

IsBetween ↔️

var date = DateTime.Parse("2023-10-23"); var start = DateTime.Parse("2023-10-20"); var end = DateTime.Parse("2023-10-25"); date.IsBetween(start, end); // True

DiffInDays 📆

var date = DateTime.Parse("2023-10-25"); var otherDate = DateTime.Parse("2023-10-23"); date.DiffInDays(otherDate); // 2.0

DiffInMonths 📅

var date = DateTime.Parse("2023-11-23"); var otherDate = DateTime.Parse("2023-10-23"); date.DiffInMonths(otherDate); // 1.0

DiffInYears 🗓️

var date = DateTime.Parse("2024-10-23"); var otherDate = DateTime.Parse("2023-10-23"); date.DiffInYears(otherDate); // 1.0

AddBusinessDays ➕

var dateTime = DateTime.Parse("2023-10-20"); dateTime.AddBusinessDays(2); // 2023-10-24 (skips weekend)

Localization 🌍

var dateTime = new DateTime(2017, 1, 1); var relativeTime = dateTime.FromNow(new CultureInfo("es")); // 6 años atrás

Currently supported languages: English, Spanish, French, Portuguese.

Contributing 🤝

Want to add more languages? Simply create a String.[language identifier].resx file and follow the Strings.es.resx example.

License 📜

This project is licensed under the MIT License - see the LICENSE file for details.