class plotnine.scales.scale_color_datetime(**kwargs)[source]

Datetime color scale

date_breaks : str

A string giving the distance between major breaks. For example '2 weeks', '5 years'. If specified, date_breaks takes precedence over breaks.

date_labels : str

Format string for the labels. See strftime. If specified, date_labels takes precedence over labels.

date_minor_breaks : str

A string giving the distance between minor breaks. For example '2 weeks', '5 years'. If specified, date_minor_breaks takes precedence over minor_breaks.

breaks : array_like or callable, optional

Major break points. Alternatively, a callable that takes a tuple of limits and returns a list of breaks. Default is to automatically calculate the breaks.

expand : array_like, optional

Multiplicative and additive expansion constants that determine how the scale is expanded. If specified must of of length 2 or 4. Specifically the the values are of this order:

(mul, add)
(mul_low, add_low, mul_high, add_high)

If not specified, suitable defaults are chosen.

name : str, optional

Name used as the label of the scale. This is what shows up as the axis label or legend title. Suitable defaults are chosen depending on the type of scale.

labels : list or callable, optional

List of str. Labels at the breaks. Alternatively, a callable that takes an array_like of break points as input and returns a list of strings.

limits : array_like, optional

Limits of the scale. Most commonly, these are the min & max values for the scales. For scales that deal with categoricals, these may be a subset or superset of the categories.

na_value : scalar

What value to assign to missing values. Default is to assign np.nan.

palette : callable, optional

Function to map data points onto the scale. Most scales define their own palettes.

aesthetics : list, optional

list of str. Aesthetics covered by the scale. These are defined by each scale and the user should probably not change them. Have fun.

trans : str | function

Name of a trans function or a trans function. See mizani.transforms for possible options.

oob : function

Function to deal with out of bounds (limits) data points. Default is to turn them into np.nan, which then get dropped.

minor_breaks : list-like or int or callable or None

If a list-like, it is the minor breaks points. If an integer, it is the number of minor breaks between any set of major breaks. If a function, it should have the signature func(limits) and return a list-like of consisting of the minor break points. If None, no minor breaks are calculated. The default is to automatically calculate them.

rescaler : function, optional

Function to rescale data points so that they can be handled by the palette. Default is to rescale them onto the [0, 1] range. Scales that inherit from this class may have another default.

lut : None | int

This is the number of entries desired in the lookup table. Default is None, leave it up Matplotlib.