PySpark SQL Functions | round method

Machine Learning

chevron_right

PySpark

chevron_right

Documentation

chevron_right

PySpark SQL Functions

schedule Jul 1, 2022

Last updated

local_offer PySpark

Parameters

1. col | string or Column

The column to perform rounding on.

2. scale | int | optional

If scale is positive, such as scale=2, then values are rounded to the nearest 2nd decimal. If scale is negative, such as scale=-1, then values are rounded to the nearest tenth. By default, scale=0, that is, values are rounded to the nearest integer.

Return Value

A PySpark Column (pyspark.sql.column.Column).

Examples

Consider the following PySpark DataFrame:


        
        
            
                
                
                    df = spark.createDataFrame([["Alex", 90.4], ["Bob", 100.5], ["Cathy", 100.63]], ["name", "salary"])
df.show()
                
            
            +-----+------+
| name|salary|
+-----+------+
| Alex|  90.4|
|  Bob| 100.5|
|Cathy|100.63|
+-----+------+

Rounding column values to the nearest integer

To round to the nearest integer:


        
        
            
                
                
                    import pyspark.sql.functions as F
df.select(F.round("salary")).show()
                
            
            +----------------+
|round(salary, 0)|
+----------------+
|            90.0|
|           101.0|
|           101.0|
+----------------+

Notice how 100.5 got rounded up to 101.

Rounding column values to the nearest first decimal

To round to the nearest 1st decimal:


        
        
            
                
                
                    df.select(F.round("salary", scale=1)).show()
                
            
            +----------------+
|round(salary, 1)|
+----------------+
|            90.4|
|           100.5|
|           100.6|
+----------------+

Rounding column values to the nearest tenth

To round to the nearest tenth:


        
        
            
                
                
                    df.select(F.round("salary", scale=-1)).show()
                
            
            +-----------------+
|round(salary, -1)|
+-----------------+
|             90.0|
|            100.0|
|            100.0|
+-----------------+

Published by Isshin Inada

Edited by 0 others

Did you find this page useful?

thumb_up

thumb_down

Comment

Citation

Share on Twitter

Share on Facebook

Ask a question or leave a feedback...

Official PySpark Documentation

https://spark.apache.org/docs/latest/api/python/reference/api/pyspark.sql.functions.round.html

thumb_up

thumb_down

chat_bubble_outline

settings

Enjoy our search

Hit / to insta-search docs and recipes!