The time at which a published content should be visible to the customer can be controlled by validity or visibility. For more information see Section 4.6.14, “Time Dependent Visibility” in Studio User Manual.

To enable time dependent visibility, you have to pass a request header with the view date to the Headless Server. Note that this is only possible in preview mode.

The view date request header is passed as:

The graphql request controller evaluates the view date header and either sets the passed date, or, if not available, the current date as request attribute. The graphql invocation then copies the value to the GraphQLContext. The view date can be retrieved via the DataFetchingEnvironment in a data fetcher.

import static com.coremedia.caas.headless_server.plugin_support.PluginSupport.CONTEXT_PARAMETER_NAME_PREVIEW_DATE;
ZonedDateTime viewDate = dataFetchingEnvironment.getGraphQlContext().get(CONTEXT_PARAMETER_NAME_PREVIEW_DATE);

The validity check of content items is performed in the ValidityDateFilterPredicate which is configured in CaasConfig.

The visibility of content items is checked in the PageGridAdapter.