Localization in Xamarin Calendar (SfCalendar)

12 May 20213 minutes to read

SfCalendar control is available with complete localization support. Localization can be specified by setting the Locale property of the control using the format of Language code followed by Country code.

Change default control language

Based on the locale specified, the strings in the control are localized accordingly.

  • c#
  • SfCalendar  calendar = new SfCalendar ();
    calendar.Locale= new System.Globalization.CultureInfo("zh-CN");
    this.Content = calendar;

    NOTE

    By default, SfCalendar control is available with en-US locale.

    Localization support in Xamarin.Forms SfCalendar

    Localizing custom strings from PCL

    You can localize the custom strings (All Day, No Events) used in the calendar control from PCL. It can be achieved by providing the custom strings to the specific language resx file and handling the required culture with the locale. In the below code, we have set Portugal as Calendar locale as well as custom strings.

    calendar.Locale = new System.Globalization.CultureInfo("pt-PT");
      CalendarResourceManager.Manager = new System.Resources.ResourceManager("Sample name.Resources.Syncfusion.SfCalendar.XForms", GetType().GetTypeInfo().Assembly);
      CultureInfo.CurrentUICulture = new CultureInfo("pt");

    Adding resx file

    You need to add the required resx files under the Resources folder in the PCL project and the filename should be Syncfusion.SfCalendar.Forms.LanguageCode.resx.

    Example: For Portuguese, Syncfusion.SfCalendar.Forms.pt.resx

    Localization support in Xamarin.Forms SfCalendar
    Now, set the Build Action as EmbeddedResource for Syncfusion.SfCalendar.Forms.pt.resx file and Build Action as Compile for Syncfusion.SfCalendar.Forms.pt.Designer.cs file.

    Localization support in Xamarin.Forms SfCalendar

    You can download the entire source code of this demo for Xamarin.Forms from
    here LocaleFromPCL.

    Localizing the custom texts using platform renderer

    You can localize the custom strings used in the calendar control. For that you need to configure it for each platform separately.

    • Localizing custom text in Android renderer.
    • Localizing custom text in iOS renderer.

    Localizing custom text in Android renderer

    You can localize custom text available in the control by adding equivalent localized string in the string.xml file.

    <resources>
      <string name="sfcalendar_inlineviewnoappointmenttext">Aucun événement</string>
      <string name="sfcalendar_inlineviewalldaytext">Toute la journée</string>
    </resources>

    Android can select and load resources from different directories, based on the current device configuration and locale, refer here. For an example, if an application requires multiple languages you can follow the below steps.

    The procedure for creating strings.xml files is as follows:

    • Translate the strings.xml file to each language.
    • Create new folders under resource as values-ar, values-de, values-en and values-fr (The original values folder already exists).
    • Place the translated strings.xml files in the respective folders.

    Localization support in Xamarin.Forms SfCalendar

    NOTE
    The corresponding Locale values folder updates only when the device language changes.

    Localizing custom text in iOS renderer

    You can localize custom text available in the control by adding equivalent localized string in the Localizable.strings file, refer here.

    Localization support in Xamarin.Forms SfCalendar

    If an application requires multiple languages you can follow the below steps:

    • Translate the Localizable.Strings file to each language.
    • Create new <Language>.lproj folders under resource as en.lproj, fr.lproj, de.lproj.
    • Place the Localizable.Strings file in the respective <Language>.lproj folders.

    Localization support in Xamarin.Forms SfCalendar

    NOTE
    The corresponding <Language>.lproj folder updates only when the device language changes.

    You can download the entire source code of this demo for Xamarin.Forms from
    here Localization.

    See also

    How to add new languages in SfCalendar control