(../../api/polars.exceptions.SchemaError.html)
    * [ polars.exceptions.SchemaFieldNotFoundError ](../../api/polars.exceptions.SchemaFieldNotFoundError.html)
    * [ polars.exceptions.ShapeError ](../../api/polars.exceptions.ShapeError.html)
    * [ polars.exceptions.StructFieldNotFoundError ](../../api/polars.exceptions.StructFieldNotFoundError.html)
    * [ polars.exceptions.TooManyRowsReturnedError ](../../api/polars.exceptions.TooManyRowsReturnedError.html)

  * [ Testing ](../../testing.html) __
    * [ polars.testing.assert_frame_equal ](../../api/polars.testing.assert_frame_equal.html)
    * [ polars.testing.assert_frame_not_equal ](../../api/polars.testing.assert_frame_not_equal.html)
    * [ polars.testing.assert_series_equal ](../../api/polars.testing.assert_series_equal.html)
    * [ polars.testing.assert_series_not_equal ](../../api/polars.testing.assert_series_not_equal.html)
    * [ polars.testing.parametric.dataframes ](../../api/polars.testing.parametric.dataframes.html)
    * [ polars.testing.parametric.series ](../../api/polars.testing.parametric.series.html)
    * [ polars.testing.parametric.column ](../../api/polars.testing.parametric.column.html)
    * [ polars.testing.parametric.columns ](../../api/polars.testing.parametric.columns.html)
    * [ polars.testing.parametric.create_list_strategy ](../../api/polars.testing.parametric.create_list_strategy.html)
    * [ polars.testing.parametric.load_profile ](../../api/polars.testing.parametric.load_profile.html)
    * [ polars.testing.parametric.set_profile ](../../api/polars.testing.parametric.set_profile.html)

  * [ Metadata ](../../metadata.html) __
    * [ polars.build_info ](../../api/polars.build_info.html)
    * [ polars.get_index_type ](../../api/polars.get_index_type.html)
    * [ polars.show_versions ](../../api/polars.show_versions.html)
    * [ polars.thread_pool_size ](../../api/polars.thread_pool_size.html)
    * [ polars.threadpool_size ](../../api/polars.threadpool_size.html)

  * [ __ ](../../../index.html)
  * [ Python API reference ](../../index.html)
  * __
  * [ List ](../list.html)
  * polars.Serie... 

#  polars.Series.list.diff  #

Series.list.  diff  (  _ n  :  [ int
](https://docs.python.org/3/library/functions.html#int "\(in Python v3.12\)")
=  1  _ , _ null_behavior  :  NullBehavior  =  'ignore'  _ )  →  Series  [
[source]  ](https://github.com/pola-rs/polars/blob/py-0.20.23/py-
polars/polars/series/list.py#L636-L673) #

    

Calculate the first discrete difference between shifted items of every
sublist.

Parameters  :

    

**n**

    

Number of slots to shift.

**null_behavior** {‘ignore’, ‘drop’}

    

How to handle null values.

Examples

    
    
    >>> s = pl.Series("a", [[1, 2, 3, 4], [10, 2, 1]])
    >>> s.list.diff()
    shape: (2,)
    Series: 'a' [list[i64]]
    [
        [null, 1, … 1]
        [null, -8, -1]
    ]
    
    
    
    >>> s.list.diff(n=2)
    shape: (2,)
    Series: 'a' [list[i64]]
    [
        [null, null, … 2]
        [null, null, -9]
    ]
    
    
    
    >>> s.list.diff(n=2, null_behavior="drop")
    shape: (2,)
    Series: 'a' [list[i64]]
    [
        [2, 2]
        [-9]
    ]
    

[ __ previous  polars.Series.list.count_matches
](polars.Series.list.count_matches.html "previous page") [ next
polars.Series.list.eval  __ ](polars.Series.list.eval.html "next page")

__ On this page

  * ` Series.list.diff()  `

© Copyright 2020, Ritchie Vink.  

Created using [ Sphinx ](https://www.sphinx-doc.org/) 7.2.4.  

Built with the [ PyData Sphinx Theme ](https://pydata-sphinx-
theme.readthedocs.io/en/stable/index.html) 0.14.1.