Child pages
  • How to format dates and numbers
Skip to end of metadata
Go to start of metadata

A frequently asked question is how best to display dates and numbers using a specified format. There are a number of approaches for this, the most naive of which would be to add a method to your action class to do the formatting for you. This method would take in a Date (or subclass) object as a parameter, and return a formatted String.

That approach however suffers from a number of flaws. For example, it is not i18n aware. The date format specified is rigid, and will not adapt to different locales easily (assuming you're not using a default formatter that is). It also clutters up your actions with code that has nothing to do with the action itself.

Instead, the recommended approach is to use Java's built-in date formatting features via use of the s:text tag.

While the s:text tag is still very useful to format numbers, date formatting has become a lot easier thanks to the s:date tag.

The s:text tag should be used for all i18n values. It will look up the properties file for your action, and from that select the value for the key that you specify. This is best illustrated in an example:

The above tag will work as follows. value0 will result in a call to getCartItems() on your action class. The cart.items name is escaped, so it is treated as a literal key into the actions' properties file. Your file will contain the following:

cart.items=You have {0} items in your cart.

Normal Java MessageFormat behaviour will correctly substitute {0} with the value obtained from getCartItems.

Needless to say, this can get a lot more elaborate, with the ability to specify both date and number formatting. Let us consider another example. The goal here is to display a greeting to the user, as well as the date of their last visit. contains:

Your file will then contain:

last.visit=Welcome back {0}, your last visit was at {1,date,HH:mm dd-MM-yyyy}

As you can see, this is a very powerful mechanism and allows you to easily display numbers and dates using any formatting rules that Java allows.

value0 interface deprecated

The examples above pass in the values as:

These values should now (>2.1.7?) be passed as params:

Some message format examples

Here are some examples of formatting in the properties file:

  • No labels

1 Comment

  1. You don't need the single quotes
    In the examples, the attribue values within the tags include single quotes; these may be required if you are specifying a literal value, however if (like in the example) you are referencing a key to be found within a resource bundle (for the name) and a value from the stack (for the value), single quotes must not be used.