String.Format.Js 1.14.0

There is a newer version of this package available.
See the version list below for details.
Install-Package String.Format.Js -Version 1.14.0
dotnet add package String.Format.Js --version 1.14.0
<PackageReference Include="String.Format.Js" Version="1.14.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add String.Format.Js --version 1.14.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: String.Format.Js, 1.14.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install String.Format.Js as a Cake Addin
#addin nuget:?package=String.Format.Js&version=1.14.0

// Install String.Format.Js as a Cake Tool
#tool nuget:?package=String.Format.Js&version=1.14.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

String.format for JavaScript

This is a JavaScript library for string, date and number formatting. Formatting is done using format strings almost completely compatible with the String.Format method in Microsoft .NET Framework.

How to use

To use the library, include the library itself and optionally the cultures you are targetting. Note that if no culture files are included, the invariant culture will be used.

<script type="text/javascript" src="stringformat-X.XX.min.js"></script>
<script type="text/javascript" src="cultures/stringformat.en.js"></script>
<script type="text/javascript" src="cultures/stringformat.sv.js"></script>

Then you're ready to go. Here are two simple examples using indexes and object paths/named parameters.

// Index
String.format(
    "Welcome back, {0}! Last seen {1:M}", 
    "John Doe", new Date(1985, 3, 7, 12, 33)
    );
    
// Outputs: 
// Welcome back, John Doe! Last seen April 07

// Named parameters
String.format(
    "Welcome back, {user.name}! Last seen {lastseen:M}", 
    { 
        user: {
            name : "John Doe", 
            age : 42
        },
        lastseen: new Date(2009, 3, 7, 12, 33) 
    });
    
// Outputs: 
// Welcome back, John Doe! Last seen April 07

By default the browser culture will be used, given that the appropriate culture file has been referenced from the page. To set culture explicitly, use the sffjs.setCulture method, which accepts a IETF language code.

sffjs.setCulture("sv");

See more

Compatibility with .NET implementation

The output of this library is highly compatible with the output from the .NET implementation. In this section differences will be listed

  • Date format
    • Date format specifier O is not supported
    • Date format specifier R is not supported
  • Number format
    • Number format specifier c ignores specified precision

Other types does not have a format implementation, and is thus serialized to a string by the __Format function or the Javascript runtime using the toString function.

These are additions in this implementation, and thus not supported by the .NET implementation:

  • Object paths/named parameters

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.17.0 775 10/18/2020
1.16.1 874 7/22/2019
1.16.0 1,365 4/5/2019
1.15.0 3,811 1/27/2019
1.14.0 873 9/9/2018
1.13.0 2,353 5/17/2017
1.12.0 863 2/22/2017
1.11.0 12,516 7/31/2016
1.10.0 1,154 10/9/2015
1.9.0 5,769 1/26/2014