100

Is it possible to include the day suffix when formatting a date using DateTime.ToString()?

For example I would like to print the date in the following format - Monday 27th July 2009. However the closest example I can find using DateTime.ToString() is Monday 27 July 2009.

Can I do this with DateTime.ToString() or am I going to have to fall back to my own code?

Craig Bovis
  • 2,720
  • 3
  • 26
  • 33
  • 8
    Did someone say NodaTime? – grenade Jan 12 '10 at 17:18
  • 3
    FYI, "[date] ordinal suffix" is what these are called. "Day" typically refers to Monday-Sunday – Richard Szalay Mar 21 '17 at 00:40
  • @grenade I want this to be the answer so bad. I've been searching for the better part of an hour to format NodaTime as mentioned in the question, but as far as I can tell it doesn't work: https://nodatime.org/2.3.x/userguide/localdate-patterns (even in 2020) It looks like momentjs has this because they built their own localization model: https://momentjs.com/docs/#/i18n/ – Drew Delano Aug 11 '20 at 02:07
  • https://nodatime.org/3.0.x/userguide/limitations Additionally, all our text localization resources (day and month names) come from the .NET framework itself. That has some significant limitations, and makes Noda Time more reliant on CultureInfo than is ideal. CLDR contains more information, which should allow for features such as ordinal day numbers ("1st", "2nd", "3rd") and a broader set of supported calendar/culture combinations (such as English names for the Hebrew calendar months). – Drew Delano Aug 18 '20 at 17:57

20 Answers20

271

Another option using switch:

string GetDaySuffix(int day)
{
    switch (day)
    {
        case 1:
        case 21:
        case 31:
            return "st";
        case 2:
        case 22:
            return "nd";
        case 3:
        case 23:
            return "rd";
        default:
            return "th";
    }
}
svick
  • 236,525
  • 50
  • 385
  • 514
Lazlow
  • 3,241
  • 3
  • 21
  • 13
  • 10
    +1 Simple, easy to read, and most importantly, works for all cases. – Lynn Crumbling Apr 21 '13 at 22:13
  • 24
    @Lazlow In case you are wondering about the sudden activity: your answer was linked as an "how to do it right" example by [The Daily WTF](http://thedailywtf.com/Articles/Remember,-Remember-the-ThirtyThird-of-November.aspx). – tobias_k Oct 28 '13 at 14:01
  • @tobias_k thanks - I wondered how my minuscule reputation had doubled so quickly! – Lazlow Nov 01 '13 at 09:39
  • 1
    For those who want the full date formatting: return date.ToString("dd MMMM yyyy").Insert(2, GetDaySuffix(date.Day)); //e.g 12th January 2020 – 1fuyouinfinite Aug 02 '20 at 19:29
  • Needed this and am I am glad I found it but just sad that this formatting hasn't been updated in .NET6 still. particularly because I need this with localization. – DVS Nov 18 '22 at 17:48
70

As a reference I always use/refer to [SteveX String Formatting] 1 and there doesn't appear to be any "th" in any of the available variables but you could easily build a string with

string.Format("{0:dddd dd}{1} {0:MMMM yyyy}", DateTime.Now, (?));

You would then have to supply a "st" for 1, "nd" for 2, "rd" for 3, and "th" for all others and could be in-lined with a "? :" statement.

var now = DateTime.Now;
(now.Day % 10 == 1 && now.Day % 100 != 11) ? "st"
: (now.Day % 10 == 2 && now.Day % 100 != 12) ? "nd"
: (now.Day % 10 == 3 && now.Day % 100 != 13) ? "rd"
: "th"
Jez
  • 27,951
  • 32
  • 136
  • 233
Bryan Bailliache
  • 1,173
  • 9
  • 10
  • 23
    This would need to be further expanded to cover the other cases, otherwise you'll end up with "21th", for example. – Kasaku Jul 27 '11 at 11:37
  • 1
    For what it's worth, Microsoft's official documentation of string formatting options can be found [here](http://msdn.microsoft.com/en-us/library/fbxft59x%28v=vs.80%29.aspx). – Bobson Nov 14 '12 at 21:38
  • 9
    `DateTime.Now` is retrieved several times in the same expression, the values can be different if the code is executed around midnight. – AlexD Jul 05 '16 at 23:08
  • 1
    I fixed the code to work with numbers over 100 so you will now get `112th` instead of `112nd`. – Jez Feb 06 '21 at 15:20
  • 2
    @Jez I think there no Day of a Date above 100, check Microsoft Doc https://learn.microsoft.com/en-us/dotnet/api/system.datetime.day The Previous edit for answer must be the correct one: https://stackoverflow.com/revisions/2050854/4 and re-back your changes – ahmed hamdy Mar 22 '21 at 17:36
  • @Bobson That link is broken. – ryanwebjackson Sep 02 '21 at 14:47
45

Using a couple of extension methods:

namespace System
{
    public static class IntegerExtensions
    {
        public static string ToOccurrenceSuffix(this int integer)
        {
            switch (integer % 100)
            {
                case 11:
                case 12:
                case 13:
                    return "th";
            }
            switch (integer % 10)
            {
                case 1:
                    return "st";
                case 2:
                    return "nd";
                case 3:
                    return "rd";
                default:
                    return "th";
            }
        }
    }   

    public static class DateTimeExtensions
    {
        public static string ToString(this DateTime dateTime, string format, bool useExtendedSpecifiers)
        {
            return useExtendedSpecifiers 
                ? dateTime.ToString(format)
                    .Replace("nn", dateTime.Day.ToOccurrenceSuffix().ToLower())
                    .Replace("NN", dateTime.Day.ToOccurrenceSuffix().ToUpper())
                : dateTime.ToString(format);
        } 
    }
}

Usage:

return DateTime.Now.ToString("dddd, dnn MMMM yyyy", useExtendedSpecifiers: true);
// Friday, 7th March 2014

Note: The integer extension method can be used for any number, not just 1 to 31. e.g.

return 332211.ToOccurrenceSuffix();
// th
Oundless
  • 5,425
  • 4
  • 31
  • 33
13

Another option is using the Modulo Operator:

public string CreateDateSuffix(DateTime date)
{
    // Get day...
    var day = date.Day;

    // Get day modulo...
    var dayModulo = day%10;

    // Convert day to string...
    var suffix = day.ToString(CultureInfo.InvariantCulture);

    // Combine day with correct suffix...
    suffix += (day == 11 || day == 12 || day == 13) ? "th" :
        (dayModulo == 1) ? "st" :
        (dayModulo == 2) ? "nd" :
        (dayModulo == 3) ? "rd" :
        "th";

    // Return result...
    return suffix;
}

You would then call the above method by passing-in a DateTime object as a parameter, for example:

// Get date suffix for 'October 8th, 2019':
var suffix = CreateDateSuffix(new DateTime(2019, 10, 8));

For more info about the DateTime constructor, please see Microsoft Docs Page.

Anthony Walsh
  • 492
  • 1
  • 6
  • 14
  • 2
    @Greg That's strange as `var suffix = CreateDateSuffix(new DateTime(2013, 10, 8));` returns '8th' in my case? – Anthony Walsh Oct 31 '13 at 01:40
  • 1
    If it were appending 'th' to the string 'eight' it would be wrong, but in this case since you used the digit 8 it is correct. – gcochard Nov 03 '13 at 23:04
  • The above method as it stands takes a _DateTime_ object and I cannot see how it could be instantiated with anything other than numeric values - in this case '**8**' representing the day of the month. – Anthony Walsh Nov 03 '13 at 23:51
  • In that case, it's correct. If you were to, I don't know, replace the numeric value with the textual representation of the number, it would be wrong. I suppose that's up to whoever is doing the replacing though, to know this and replace '8t' with 'eight', or more correctly, replace '8' with 'eigh'. – gcochard Nov 04 '13 at 00:36
8

Taking @Lazlow's answer to a complete solution, the following is a fully reusable extension method, with example usage;

internal static string HumanisedDate(this DateTime date)
{
    string ordinal;

    switch (date.Day)
    {
        case 1:
        case 21:
        case 31:
            ordinal = "st";
            break;
        case 2:
        case 22:
            ordinal = "nd";
            break;
        case 3:
        case 23:
            ordinal = "rd";
            break;
        default:
            ordinal = "th";
            break;
    }

    return string.Format("{0:dddd dd}{1} {0:MMMM yyyy}", date, ordinal);
} 

To use this you would simply call it on a DateTime object;

var myDate = DateTime.Now();
var myDateString = myDate.HumanisedFormat()

Which will give you:

Friday 17th June 2016

Mark Cooper
  • 6,738
  • 5
  • 54
  • 92
8

Here is extended version including 11th, 12th and 13th:

DateTime dt = DateTime.Now;
string d2d = dt.ToString("dd").Substring(1);
string daySuffix =
    (dt.Day == 11 || dt.Day == 12 || dt.Day == 13) ? "th"
    : (d2d == "1") ? "st"
    : (d2d == "2") ? "nd"
    : (d2d == "3") ? "rd"
    : "th";
6

UPDATE

NuGet package:
https://www.nuget.org/packages/DateTimeToStringWithSuffix

Example:
https://dotnetfiddle.net/zXQX7y

Supports:
.NET Core 1.0 and higher
.NET Framework 4.5 and high


Here's an extension method (because everyone loves extension methods), with Lazlow's answer as the basis (picked Lazlow's as it's easy to read).

Works just like the regular ToString() method on DateTime with the exception that if the format contains a d or dd, then the suffix will be added automatically.

/// <summary>
/// Return a DateTime string with suffix e.g. "st", "nd", "rd", "th"
/// So a format "dd-MMM-yyyy" could return "16th-Jan-2014"
/// </summary>
public static string ToStringWithSuffix(this DateTime dateTime, string format, string suffixPlaceHolder = "$") {
    if(format.LastIndexOf("d", StringComparison.Ordinal) == -1 || format.Count(x => x == 'd') > 2) {
        return dateTime.ToString(format);
    }

    string suffix;
    switch(dateTime.Day) {
        case 1:
        case 21:
        case 31:
            suffix = "st";
            break;
        case 2:
        case 22:
            suffix = "nd";
            break;
        case 3:
        case 23:
            suffix = "rd";
            break;
        default:
            suffix = "th";
            break;
    }

    var formatWithSuffix = format.Insert(format.LastIndexOf("d", StringComparison.InvariantCultureIgnoreCase) + 1, suffixPlaceHolder);
    var date = dateTime.ToString(formatWithSuffix);

    return date.Replace(suffixPlaceHolder, suffix);
}
GFoley83
  • 3,439
  • 2
  • 33
  • 46
  • 1
    Surprised that this hasn't got more up votes, I prefer the fact that it's an extension. Makes it much easier to use and arguably more readable. – 0Neji Feb 23 '16 at 17:03
  • That NuGet Package doesn't like formats which include `ddd` or `dddd` - ie the name of the weekday. If you want to display a date as 'Thursday 4th November 2021' you need to work around that limitation - eg `Console.WriteLine(DateTime.UtcNow.ToString("dddd")+" "+DateTime.UtcNow.ToStringWithSuffix("d MMMM yyyy")); ` – John Nov 04 '21 at 10:37
3

Simpler answer using a switch expression (since C# 8):

var daySuffix = dateTime.Day switch {
                    1 or 21 or 31 => "st",
                    2 or 22 => "nd",
                    3 or 23 => "rd",
                    _ => "th",
                };
myl
  • 6,112
  • 1
  • 13
  • 6
2

I believe this to be a good solution, covering numbers such as 111th etc:

private string daySuffix(int day)
{
    if (day > 0)
    {
        if (day % 10 == 1 && day % 100 != 11)
            return "st";
        else if (day % 10 == 2 && day % 100 != 12)
            return "nd";
        else if (day % 10 == 3 && day % 100 != 13)
            return "rd";
        else
            return "th";
    }
    else
        return string.Empty;
}
Duncan
  • 21
  • 2
  • Although this is a more general purpose method, for any number, not just month days (I think). – Duncan Feb 12 '13 at 22:42
2

For those who are happy to use external dependencies (in this case the fantastic Humanizr .net), it's as simple as

dateVar.Day.Ordinalize(); \\ 1st, 4th etc depending on the value of dateVar

Gumzle
  • 847
  • 6
  • 16
1

public static String SuffixDate(DateTime date) { string ordinal;

     switch (date.Day)
     {
        case 1:
        case 21:
        case 31:
           ordinal = "st";
           break;
        case 2:
        case 22:
           ordinal = "nd";
           break;
        case 3:
        case 23:
           ordinal = "rd";
           break;
        default:
           ordinal = "th";
           break;
     }
     if (date.Day < 10)
        return string.Format("{0:d}{2} {1:MMMM yyyy}", date.Day, date, ordinal);
     else
        return string.Format("{0:dd}{1} {0:MMMM yyyy}", date, ordinal);
  }
  • 1
    This version shows only the first digit of a day ie 1st March 2017 where I didn't want the day name first as in a long date and didn't want the 01st instead of 1st – Robert Peter Bronstein Mar 21 '17 at 00:36
0

For what its worth here is my final solution using the below answers

     DateTime dt = DateTime.Now;
        string d2d = dt.ToString("dd").Substring(1); 

        string suffix =
       (dt.Day == 11 || dt.Day == 12 || dt.Day == 13) ? "th"
       : (d2d == "1") ? "st"
       : (d2d == "2") ? "nd"
       : (d2d == "3") ? "rd"
       : "th";


        Date.Text = DateTime.Today.ToString("dddd d") + suffix + " " + DateTime.Today.ToString("MMMM") + DateTime.Today.ToString(" yyyy"); 
Corbin Spicer
  • 285
  • 1
  • 8
  • 26
0

Get Date Suffix. (Static Function)

public static string GetSuffix(this string day)
{
    string suffix = "th";

    if (int.Parse(day) < 11 || int.Parse(day) > 20)
    {
        day = day.ToCharArray()[day.ToCharArray().Length - 1].ToString();
        switch (day)
        {
            case "1":
                suffix = "st";
                break;
            case "2":
                suffix = "nd";
                break;
            case "3":
                suffix = "rd";
                break;
        }
    }

    return suffix;
}

Reference: https://www.aspsnippets.com/Articles/Display-st-nd-rd-and-th-suffix-after-day-numbers-in-Formatted-Dates-using-C-and-VBNet.aspx

Manjunath Bilwar
  • 2,215
  • 19
  • 16
0

Check out humanizr: https://github.com/Humanizr/Humanizer#date-time-to-ordinal-words

new DateTime(2015, 1, 1).ToOrdinalWords() => "1st January 2015"
new DateTime(2015, 2, 12).ToOrdinalWords() => "12th February 2015"
new DateTime(2015, 3, 22).ToOrdinalWords() => "22nd March 2015"
// for English US locale
new DateTime(2015, 1, 1).ToOrdinalWords() => "January 1st, 2015"
new DateTime(2015, 2, 12).ToOrdinalWords() => "February 12th, 2015"
new DateTime(2015, 3, 22).ToOrdinalWords() => "March 22nd, 2015"

I realized right after posting this that @Gumzle suggested the same thing, but I missed his post because it was buried in code snippets. So this is his answer with enough code that someone (like me) quickly scrolling through might see it.

Drew Delano
  • 1,421
  • 16
  • 21
0

A solution you can use in a razor template. It's probably not the most elegant way but it's quick and it works

@Model.Pubdate.ToString("dddd, d'th' MMMM yyyy").Replace("1th","1st").Replace("2th", "2nd").Replace("3th", "3rd").Replace("11st", "11th").Replace("12nd", "12th").Replace("13rd", "13th")

ToString("dddd, d'th' MMMM yyyy") adds "th" after the day number, eg "Tuesday, 31th May 2022". Then use a set of string replacements to change 1th, 2th and 3th to 1st, 2nd and 3rd, and another set to change 11st, 12nd and 13rd back to 11th, 12th and 13th.

John
  • 4,658
  • 2
  • 14
  • 23
-1

A cheap and cheerful VB solution:

litDate.Text = DatePart("dd", Now) & GetDateSuffix(DatePart("dd", Now))

Function GetDateSuffix(ByVal dateIn As Integer) As String

    '// returns formatted date suffix

    Dim dateSuffix As String = ""
    Select Case dateIn
        Case 1, 21, 31
            dateSuffix = "st"
        Case 2, 22
            dateSuffix = "nd"
        Case 3, 23
            dateSuffix = "rd"
        Case Else
            dateSuffix = "th"
    End Select

    Return dateSuffix

End Function
Druid
  • 6,423
  • 4
  • 41
  • 56
Tony
  • 9
-1

I did it like this, it gets around some of the problems given in the other examples.

    public static string TwoLetterSuffix(this DateTime @this)
    {
        var dayMod10 = @this.Day % 10;

        if (dayMod10 > 3 || dayMod10 == 0 || (@this.Day >= 10 && @this.Day <= 19))
        {
            return "th";
        }
        else if(dayMod10 == 1)
        {
            return "st";
        }
        else if (dayMod10 == 2)
        {
            return "nd";
        }
        else
        {
            return "rd";
        }
    }
rashleighp
  • 1,226
  • 1
  • 13
  • 21
-1
string datestring;    
// datestring = DateTime.Now.ToString("dd MMMM yyyy"); // 16 January 2021

    // code to add 'st' ,'nd', 'rd' and 'th' with day of month 
    // DateTime todaysDate = DateTime.Now.Date; // enable this line for current date 
    DateTime todaysDate = DateTime.Parse("01-13-2021"); // custom date to verify code // 13th January 2021
    int day = todaysDate.Day;
    string dateSuffix;

    if(day==1 || day==21 || day==31){
        dateSuffix= "st";
    }else if(day==2 || day==22 ){
        dateSuffix= "nd";
    }else if(day==3 || day==23 ){
        dateSuffix= "rd";
    }else{
        dateSuffix= "th";
    }
    datestring= day+dateSuffix+" "+todaysDate.ToString("MMMM")+" "+todaysDate.ToString("yyyy");
    Console.WriteLine(datestring);
marc_s
  • 732,580
  • 175
  • 1,330
  • 1,459
mhk
  • 436
  • 6
  • 14
-4

Another option using the last string character:

public static string getDayWithSuffix(int day) {
 string d = day.ToString();
 if (day < 11 || day > 13) {
  if (d.EndsWith("1")) {
   d += "st";
  } else if (d.EndsWith("2")) {
   d += "nd";
  } else if (d.EndsWith("3")) {
   d += "rd";
  } else {
   d += "th";
 } else {
  d += "th";
 }
 return d;
}
Jodda
  • 25
  • 4
-5

in the MSDN documentation there is no reference to a culture that could convert that 17 into 17th. so You should do it manually via code-behind.Or build one...you could build a function that does that.

public string CustomToString(this DateTime date)
    {
        string dateAsString = string.empty;
        <here wright your code to convert 17 to 17th>
        return dateAsString;
    }
GxG
  • 4,491
  • 2
  • 20
  • 18