1
0
mirror of https://github.com/oliverbooth/X10D synced 2024-11-10 04:55:42 +00:00

Add DateTime(Offset).GetIso8601WeekOfYear

This commit is contained in:
Oliver Booth 2022-07-05 21:26:45 +01:00
parent 02cc897426
commit 2fb3eb77dd
No known key found for this signature in database
GPG Key ID: 32A00B35503AF634
3 changed files with 47 additions and 0 deletions

View File

@ -4,6 +4,7 @@
### Added ### Added
- X10D: Added `MathUtility.InverseLerp(float, float, float)` and `MathUtility.InverseLerp(double, double, double)` - X10D: Added `MathUtility.InverseLerp(float, float, float)` and `MathUtility.InverseLerp(double, double, double)`
- X10D: Added `Circle`, `CircleF`, `Cuboid`, `Ellipse`, `EllipseF`, `Line3D`, `Line`, `LineF`, `Polygon`, `PolygonF`, `Polyhedron`, and `Sphere`, to complement System.Drawing structs such as `Point` and `Rectangle` - X10D: Added `Circle`, `CircleF`, `Cuboid`, `Ellipse`, `EllipseF`, `Line3D`, `Line`, `LineF`, `Polygon`, `PolygonF`, `Polyhedron`, and `Sphere`, to complement System.Drawing structs such as `Point` and `Rectangle`
- X10D: Added `DateTime.GetIso8601WeekOfYear()` and `DateTimeOffset.GetIso8601WeekOfYear()`
- X10D: Added `DirectoryInfo.Clear([bool])` - X10D: Added `DirectoryInfo.Clear([bool])`
- X10D: Added `IList<T>.RemoveRange(Range)` - X10D: Added `IList<T>.RemoveRange(Range)`
- X10D: Added `Point.IsOnLine(LineF)`, `Point.IsOnLine(PointF, PointF)`, and `Point.IsOnLine(Vector2, Vector2)` - X10D: Added `Point.IsOnLine(LineF)`, `Point.IsOnLine(PointF, PointF)`, and `Point.IsOnLine(Vector2, Vector2)`

View File

@ -1,4 +1,5 @@
using System.Diagnostics.Contracts; using System.Diagnostics.Contracts;
using System.Globalization;
using System.Runtime.CompilerServices; using System.Runtime.CompilerServices;
namespace X10D.Time; namespace X10D.Time;
@ -58,6 +59,32 @@ public static class DateTimeExtensions
return ((DateTimeOffset)value).FirstDayOfMonth().DateTime; return ((DateTimeOffset)value).FirstDayOfMonth().DateTime;
} }
/// <summary>
/// Gets the ISO-8601 week number of the year for the current date.
/// </summary>
/// <param name="value">The date whose week number to return.</param>
/// <returns>The ISO-8601 week number of the year.</returns>
/// <author>Shawn Steele, Microsoft</author>
/// <remarks>
/// This implementation is directly inspired from a
/// <a href="https://docs.microsoft.com/en-gb/archive/blogs/shawnste/iso-8601-week-of-year-format-in-microsoft-net">
/// blog post
/// </a>.
/// about this subject.
/// </remarks>
[Pure]
public static int GetIso8601WeekOfYear(this DateTime value)
{
var calendar = CultureInfo.InvariantCulture.Calendar;
DayOfWeek day = calendar.GetDayOfWeek(value);
if (day is >= DayOfWeek.Monday and <= DayOfWeek.Wednesday)
{
value = value.AddDays(3);
}
return calendar.GetWeekOfYear(value, CalendarWeekRule.FirstFourDayWeek, DayOfWeek.Monday);
}
/// <summary> /// <summary>
/// Returns a value indicating whether the year represented by the current <see cref="DateTime" /> is a leap year. /// Returns a value indicating whether the year represented by the current <see cref="DateTime" /> is a leap year.
/// </summary> /// </summary>

View File

@ -84,6 +84,25 @@ public static class DateTimeOffsetExtensions
return value.AddDays(1 - value.Day); return value.AddDays(1 - value.Day);
} }
/// <summary>
/// Gets the ISO-8601 week number of the year for the current date.
/// </summary>
/// <param name="value">The date whose week number to return.</param>
/// <returns>The ISO-8601 week number of the year.</returns>
/// <author>Shawn Steele, Microsoft</author>
/// <remarks>
/// This implementation is directly inspired from a
/// <a href="https://docs.microsoft.com/en-gb/archive/blogs/shawnste/iso-8601-week-of-year-format-in-microsoft-net">
/// blog post
/// </a>.
/// about this subject.
/// </remarks>
[Pure]
public static int GetIso8601WeekOfYear(this DateTimeOffset value)
{
return value.DateTime.GetIso8601WeekOfYear();
}
/// <summary> /// <summary>
/// Returns a value indicating whether the year represented by the current <see cref="DateTimeOffset" /> is a leap year. /// Returns a value indicating whether the year represented by the current <see cref="DateTimeOffset" /> is a leap year.
/// </summary> /// </summary>