Change the Date Format to German during Mail Merge in ASP.NET Word.
Syncfusion® Essential DocIO is a ASP.NET Word library used to create, read, edit, and convert Word documents programmatically without Microsoft Word or interop dependencies. Using this library, you can change the date format to German culture during mail merge in Word document using C#.
DocIO replaces merge fields with their values but does not modify date fields during mail merge. To maintain the German date format, set up the template with a merge field for the date as like Date: { MERGEFIELD_Date @ d MMMM yyyy}. During mail merge execution, use the MergeFieldEventHandler to convert the date value to German culture (de-DE) before assigning it to the merge field. This ensures the correct format is applied in the final document.
Steps to change the date format to German culture during mail merge in Word document:
- Create a new .NET Core console application project.
- Install the Syncfusion.DocIO.Net.Core NuGet package as a reference to your project from NuGet.org.
Starting with v16.2.0.x, if you reference Syncfusion® assemblies from trial setup or from the NuGet feed, include a license key in your projects. Refer to the link to learn about generating and registering a Syncfusion® license key in your application to use the components without trail message.
- Include the following namespaces in Program.cs file
C#
using Syncfusion.DocIO.DLS;
using Syncfusion.DocIO;
- Use the following code example to change the date format to German culture using MergeFieldEvent handler.
C#
using (FileStream fileStream = new FileStream(Path.GetFullPath("Template.docx"), FileMode.Open, FileAccess.ReadWrite))
{
//Opens the template document.
using (WordDocument document = new WordDocument(fileStream, FormatType.Docx))
{
//Execute mail merge
string[] fieldnames = { "Name", "Date" };
string[] fieldvalues = { "Andrew", DateTime.Now.ToString() };
//Hook the even to do the date format changes during mail merge.
document.MailMerge.MergeField += ChangeDateLanguauge;
document.MailMerge.Execute(fieldnames, fieldvalues);
//Creates file stream.
using (FileStream outputStream = new FileStream(Path.GetFullPath("Result.docx"), FileMode.Create, FileAccess.ReadWrite))
{
//Saves the Word document to file stream.
document.Save(outputStream, FormatType.Docx);
}
}
}
- Use the following code example to change the date value to German culture in the same date format.
C#
static void ChangeDateLanguauge(object sender, MergeFieldEventArgs args)
{
//Check whether date is merge for this merge field.
if (args.FieldName == "Date")
{
//Get the date value.
string dateValue = args.FieldValue.ToString();
//Parse the date value.
DateTime date = DateTime.Parse(dateValue);
//Convert the date value to German culture in the same date format.
string formattedDate = date.ToString(args.CurrentMergeField.DateFormat, new System.Globalization.CultureInfo("de-DE"));
//Set the date value to the current merge field.
args.Text = formattedDate;
}
}
You can download a complete working sample to change the date format to German culture during mail merge in Word document from the GitHub.
Take a moment to peruse the documentation where you can find basic Word document processing options along with the features like mail merge, merge, split, and compare Word documents, find and replace text in the Word document, protect the Word documents, and most importantly, the PDF and Image conversions with code examples.
Conclusion
I hope you enjoyed learning about how to change the date format to German during mail merge in ASP.NET Word.
You can refer to our ASP.NET Core DocIO feature tour page to know about its other groundbreaking feature representations and documentation, and how to quickly get started for configuration specifications. You can also explore our ASP.NET Core DocIO example to understand how to create and manipulate data.
For current customers, you can check out our components from the License and Downloads page. If you are new to Syncfusion®, you can try our 30-day free trial to check out our other controls.
If you have any queries or require clarifications, please let us know in the comments section below. You can also contact us through our support forums, Direct-Trac, or feedback portal. We are always happy to assist you!