Field formatter for a date time field. More...

#include <qgsdatetimefieldformatter.h>

Inheritance diagram for QgsDateTimeFieldFormatter:

Public Member Functions
	QgsDateTimeFieldFormatter ()=default
	Date time display format is localized by applyLocaleChange.

QString	id () const override
	Returns a unique id for this field formatter.

QString	representValue (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config, const QVariant &cache, const QVariant &value) const override
	Create a pretty String representation of the value.

Public Member Functions inherited from QgsFieldFormatter
	QgsFieldFormatter ()=default
	Default constructor.

virtual	~QgsFieldFormatter ()=default

virtual Qt::AlignmentFlag	alignmentFlag (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config) const
	Returns the alignment for a particular field.

virtual QVariantList	availableValues (const QVariantMap &config, int countLimit, const QgsFieldFormatterContext &context) const
	Returns a list of the values that would be possible to select with this widget type On a RelationReference that would be the parents ids or on ValueMap all the configured keys according to the settings in the config.

virtual QVariant	createCache (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config) const
	Create a cache for a given field.

Flags	flags () const
	Returns the flags.

virtual QList< QgsVectorLayerRef >	layerDependencies (const QVariantMap &config) const SIP_SKIP
	Returns a list of weak layer references to other layers required by this formatter for the given config.

void	setFlags (const Flags &flags)
	Sets the flags.

enum Flag	SIP_ENUM_BASETYPE (IntFlag)
	Flags for the abilities of the formatter.

virtual QVariant	sortValue (QgsVectorLayer *layer, int fieldIndex, const QVariantMap &config, const QVariant &cache, const QVariant &value) const
	If the default sort order should be overwritten for this widget, you can transform the value in here.

Static Public Member Functions
static void	applyLocaleChange ()
	Adjusts the date time display formats according to locale.

static QString	defaultDisplayFormat (QVariant::Type type)
	Gets the default display format in function of the type.

static QString	defaultFormat (QVariant::Type type)
	Gets the default format in function of the type.

Public Attributes
	SIP_SKIP

Static Public Attributes
static QString	DATE_DISPLAY_FORMAT = QStringLiteral( "yyyy-MM-dd" )

static const QString	DATE_FORMAT = QStringLiteral( "yyyy-MM-dd" )

static QString	DATETIME_DISPLAY_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss" )
	Date display format is localized by applyLocaleChange.

static const QString	DATETIME_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss" )

static const QString	DISPLAY_FOR_ISO_FORMAT = QStringLiteral( "yyyy-MM-dd HH:mm:ss+t" )

static const QString	QT_ISO_FORMAT = QStringLiteral( "Qt ISO Date" )
	Date time format was localized by applyLocaleChange before QGIS 3.30.

static const QString	TIME_FORMAT = QStringLiteral( "HH:mm:ss" )
	Date format was localized by applyLocaleChange before QGIS 3.30.

Detailed Description

Field formatter for a date time field.

This represents a date, time or datetime value based on the field configuration.

Definition at line 30 of file qgsdatetimefieldformatter.h.

Constructor & Destructor Documentation

◆ QgsDateTimeFieldFormatter()

QgsDateTimeFieldFormatter::QgsDateTimeFieldFormatter ( )

default

Date time display format is localized by applyLocaleChange.

See also: applyLocaleChange

Since: QGIS 3.30 Default constructor of field formatter for a date time field.

Member Function Documentation

◆ applyLocaleChange()

void QgsDateTimeFieldFormatter::applyLocaleChange ( )

static

Adjusts the date time display formats according to locale.

Before QGIS 3.30, the date time formats was adjusted.

Since: QGIS 3.22.2

Definition at line 135 of file qgsdatetimefieldformatter.cpp.

◆ defaultDisplayFormat()

QString QgsDateTimeFieldFormatter::defaultDisplayFormat ( QVariant::Type type )

static

Gets the default display format in function of the type.

The type is expected to be one of

QVariant::DateTime
QVariant::Date
QVariant::Time

Since: QGIS 3.30

Definition at line 122 of file qgsdatetimefieldformatter.cpp.

◆ defaultFormat()

QString QgsDateTimeFieldFormatter::defaultFormat ( QVariant::Type type )

static

Gets the default format in function of the type.

The type is expected to be one of

QVariant::DateTime
QVariant::Date
QVariant::Time

Definition at line 109 of file qgsdatetimefieldformatter.cpp.

◆ id()

QString QgsDateTimeFieldFormatter::id ( ) const

overridevirtual

Returns a unique id for this field formatter.

This id will later be used to identify this field formatter in the registry with QgsFieldFormatterRegistry::fieldFormatter().

This id matches the id of a QgsEditorWidgetFactory.

Implements QgsFieldFormatter.

Definition at line 35 of file qgsdatetimefieldformatter.cpp.

◆ representValue()

QString QgsDateTimeFieldFormatter::representValue	(	QgsVectorLayer *	layer,
		int	fieldIndex,
		const QVariantMap &	config,
		const QVariant &	cache,
		const QVariant &	value
	)		const