Support and Documentation

Formatting dates using view models

You can set the default date format from within the content type's view model. When resolving the date format to use, Brightspot checks for this configuration if there is no date format specified in a theme's properties (as described in Date formats and resource bundles) or in a site's settings (as described in Configuring a site's date format).

package brightspot.core.article;

import brightspot.view.core.article.ArticlePageView;
import brightspot.core.tool.DateTimeUtils;
import com.psddev.cms.view.PageEntryView;
import com.psddev.cms.view.ViewModel;

public class ArticlePageViewModel extends ViewModel<Article> implements ArticlePageView, PageEntryView {

    protected PageViewModel page;

    private static final String DATE_FORMAT_KEY = "dateFormat";
    private static final String DEFAULT_DATE_FORMAT = "MMMM d, yyyy";

    public CharSequence getDatePublished() {
        return DateTimeUtils.format(model.getPublishDate(), ArticlePageView.class, DATE_FORMAT_KEY, page.getSite(), DEFAULT_DATE_FORMAT);

    /* Other Getters */

In the previous snippet—

  • Lines 11–12 declare a variable page and assign it the default value PageViewModel.class.

  • Line 15 declares a date format string.

  • Line 19 retrieves the model's publication date and outputs the date using the configured format string.