Add date filter in an Excel worksheet

This REST API indicates to add a date filter on an Excel Worksheet.

RSET API


PUT http://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/autoFilter/dateFilter

The request parameters are:

Parameter Name	Type	Path/Query String/HTTPBody	Description
name	string	Path	The workbook name.
sheetName	string	Path	The worksheet name.
range	string	Query
fieldIndex	integer	Query
dateTimeGroupingType	string	Query	Day/Hour/Minute/Month/Second/Year
year	integer	Query
month	integer	Query
day	integer	Query
hour	integer	Query
minute	integer	Query
second	integer	Query
matchBlanks	string	Query	true/false
refresh	string	Query	true/false
folder	string	Query	Original workbook folder.
storageName	string	Query	Storage name.

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

You can use cURL command-line tool to access Aspose.Cells web services easily. The following example shows how to make calls to Cloud API with cURL.

Request


curl -v "http://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/autoFilter/dateFilter?range=A1:B1&fieldIndex=0&dateTimeGroupingType=Year&year=1920&refresh=true" \
-X PUT \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"

Response

{
  "Code": 200,
  "Status": "OK"
}

Cloud SDK Family

Using an SDK is the best way to speed up the development. An SDK takes care of low-level details and lets you focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to make calls to Aspose.Cells web services using various SDKs:

	// For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-dotnet/
	namespace Aspose.Cells.Cloud.SDK.Example
	{
	using Aspose.Cells.Cloud.SDK.Api;
	using Aspose.Cells.Cloud.SDK.Request;
	using System;
	using System.Collections.Generic;
	using System.IO;

	public partial class CellsApiExample
	{
	public void PutWorksheetCustomFilterExample1()
	{
	CellsApi cellsApi = new CellsApi(Environment.GetEnvironmentVariable("CellsCloudTestClientId"), Environment.GetEnvironmentVariable("CellsCloudTestClientSecret"));
	IDictionary<string, Stream> mapFiles = new Dictionary<string, Stream>();
	mapFiles.Add("Book1.xlsx", File.OpenRead(@"TestData\Book1.xlsx"));
	mapFiles.Add("myDocument.xlsx", File.OpenRead(@"TestData\myDocument.xlsx"));
	PutWorksheetCustomFilterRequest request = new PutWorksheetCustomFilterRequest
	{
	name = "Book1.xlsx",
	sheetName = "Sheet1",
	range = "A1:C3",
	fieldIndex = 0,
	operatorType1 = "LessOrEqual",
	criteria1 = "test",
	isAnd = false,
	operatorType2 = "LessOrEqual",
	criteria2 = "test",
	matchBlanks = true,
	refresh = false,
	folder = "TestData/In"
	};
	cellsApi.PutWorksheetCustomFilter(request);
	}
	}
	}

view raw Examples-DotNet-CSharp-Worksheet-AddDataFilter-1.cs hosted with ❤ by GitHub

Java

	package com.aspose.cloud.cells.api;
	import com.aspose.cloud.cells.client.*;
	import com.aspose.cloud.cells.model.*;
	import com.aspose.cloud.cells.request.*;
	import java.io.IOException;
	import org.junit.Test;
	import java.util.ArrayList;
	import java.util.List;
	import java.io.File;
	import java.util.HashMap;

	public class Example {
	private CellsApi api;
	public Example(){
	try {
	api = new CellsApi(
	System.getenv("CellsCloudClientId"),
	System.getenv("CellsCloudClientSecret"),
	"v3.0",
	System.getenv("CellsCloudApiBaseUrl")
	);
	} catch (ApiException e) {
	e.printStackTrace();
	}
	}
	public void Run(){
	try{
	String remoteFolder = "TestData/In";

	String localName = "Book1.xlsx";
	String remoteName = "Book1.xlsx";

	UploadFileRequest uploadFileRequest = new UploadFileRequest();
	uploadFileRequest.setPath( remoteFolder + "/" + remoteName );
	uploadFileRequest.setStorageName( "");
	HashMap<String,File> files = new HashMap<String,File>();
	files.put( localName , new File(localName ));
	uploadFileRequest.setUploadFiles(files);
	api.uploadFile(uploadFileRequest);
	PutWorksheetDateFilterRequest request = new PutWorksheetDateFilterRequest();
	request.setName(remoteName);
	request.setSheetName("Sheet1");
	request.setRange("RANGE");
	request.setFieldIndex(0);
	request.setDateTimeGroupingType("Day");
	request.setYear(2023);
	request.setMonth(11);
	request.setDay(1);
	request.setHour(1);
	request.setMinute(1);
	request.setSecond(1);
	request.setMatchBlanks(true);
	request.setRefresh(false);
	request.setFolder(remoteFolder);
	request.setStorageName("");

	CellsCloudResponse response = api.putWorksheetDateFilter(request);

	} catch (ApiException e) {
	e.printStackTrace();
	}catch (IOException e) {
	e.printStackTrace();
	}
	}
	}

view raw Examples-Java-filters-AddDateWorksheetExample-1.java hosted with ❤ by GitHub

PHP

	<?php
	# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-php
	require_once('vendor\autoload.php');
	use \Aspose\Cells\Cloud\Api\CellsApi;
	use \Aspose\Cells\Cloud\Request\PutWorksheetDateFilterRequest;

	class FilterData {

	public $instance;

	public function __construct() {
	$this->instance = new CellsApi(getenv("CellsCloudClientId"),getenv("CellsCloudClientSecret"),"v3.0",getenv("CellsCloudApiBaseUrl"));
	}

	public function putWorksheetDateFilter() {
	$remoteFolder = "TestData/In";

	$localName = "Book1.xlsx";
	$remoteName = "Book1.xlsx";
	$request = new PutWorksheetDateFilterRequest();
	$request->setName( $remoteName);
	$request->setSheetName( "Sheet1");
	$request->setRange( "A1:B1");
	$request->setFieldIndex( 0);
	$request->setDateTimeGroupingType( "Year");
	$request->setYear( 1920);
	$request->setMatchBlanks( 'false');
	$request->setRefresh( 'true');
	$request->setFolder( $remoteFolder);
	$request->setStorageName( "");
	$this->instance->putWorksheetDateFilter($request);
	}
	}

	$instance = new FilterData();
	$instance->putWorksheetDateFilter();

	?>

view raw Examples-PHP-AutoFilter-PutWorksheetDateFilter-.php hosted with ❤ by GitHub

Ruby

	# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-ruby
	require 'aspose_cells_cloud'

	class Cell

	include AsposeCellsCloud


	def initialize
	#Get client_id and client_secret from https://cloud.aspose.com

	@instance = AsposeCellsCloud::CellsApi.new($client_id,$client_secret,$api_version,$baseurl)
	end

	# Clear cells contents.
	def put_worksheet_date_filter
	name = $BOOK1
	sheet_name = $SHEET1
	range = $RANGE
	field_index = 0
	date_time_grouping_type = 'Day'
	year = 2019
	month = 1
	day = 1
	hour = 1
	minute = 1
	second = 1
	match_blanks = true
	refresh = true
	folder = $TEMPFOLDER
	result = @instance.upload_file( folder+"/"+name, ::File.open(File.expand_path("data/"+name),"r") {\|io\| io.read(io.size) })
	expect(result.uploaded.size).to be > 0
	result = @instance.cells_auto_filter_put_worksheet_date_filter(name, sheet_name, range, field_index, date_time_grouping_type, {:year=>year, :month=>month, :day=>day, :hour=>hour, :minute=>minute, :second=>second, :match_blanks=>match_blanks, :refresh=>refresh, :folder=>folder})
	expect(result.code).to eql(200)

	end

	end

	cell = Cell.new()
	puts cell.put_worksheet_date_filter

view raw Examples-Ruby-AutoFilter-put_worksheet_date_filter-.rb hosted with ❤ by GitHub

Node.js

	const { CellsApi, UploadFileRequest, CellsAutoFilter_PutWorksheetDateFilterRequest } = require("asposecellscloud");
	const clientId = process.env.CellsCloudClientId;
	const clientSecret = process.env.CellsCloudClientSecret;
	const ApiURL = process.env.CellsCloudApiBaseUrl;
	const fs = require('fs');
	const path = require('path');
	const cellsApi = new CellsApi(clientId, clientSecret,"v3.0",ApiURL);
	const localPath = "D:/aspose-cells-cloud-node/TestData/"

	const filename = "Book1.xlsx";
	const data =fs.createReadStream(path.join(localPath, filename));

	const req = new UploadFileRequest({
	path: "Temp/" + filename,
	file: data
	});
	cellsApi.uploadFile(req)
	.then((result) => {

	const req = new CellsAutoFilter_PutWorksheetDateFilterRequest();
	req.name = filename;
	req.sheetName = "Sheet1";
	req.range = "A1:C10";
	req.fieldIndex = 0;
	req.dateTimeGroupingType = "Day";
	req.year = 2019;
	req.month = 1;
	req.day = 1;
	req.hour = 1;
	req.minute = 1;
	req.second = 1;
	req.matchBlanks = true;
	req.refresh = true;
	req.folder = "Temp";
	cellsApi.cellsAutoFilterPutWorksheetDateFilter(req)
	.then((result) => {
	console.log("successful")

	}).catch((error) => {
	console.error('Unhandled Promise Rejection:', error);
	})
	})

view raw Examples-Node.js-SDK-Worksheet-AddDateFilter-1.js hosted with ❤ by GitHub

Android

	try
	{
	CellsApi api = new CellsApi(CellsApiUtil.GetClientId(),CellsApiUtil.GetClientSecret(),CellsApiUtil.GetAPIVersion(),CellsApiUtil.GetBaseUrl());
	String name = BOOK1;
	String sheetName = SHEET1;
	String range = RANGE;
	Integer fieldIndex = 0;
	String dateTimeGroupingType = "Day";
	Integer year = 2010;
	Integer month = 10;
	Integer day = 1;
	Integer hour = 1;
	Integer minute = 1;
	Integer second = 1;
	Boolean matchBlanks = true;
	Boolean refresh = null;
	String folder = TEMPFOLDER;
	CellsApiUtil.Upload(api, folder , name);
	CellsCloudResponse response = api.cellsAutoFilterPutWorksheetDateFilter(name, sheetName, range, fieldIndex, dateTimeGroupingType, year, month, day, hour, minute, second, matchBlanks, refresh, folder,null);
	}
	catch (Exception ex)
	{
	ex.printStackTrace();
	}

view raw Examples-Android-filters-AddDateWorksheetExample-1.java hosted with ❤ by GitHub

Perl

	# For complete examples and data files, please go to https://github.com/aspose-cells-cloud/aspose-cells-cloud-perl/
	use strict;
	use warnings;
	use utf8;
	use File::Slurp;
	use MIME::Base64;
	use AsposeCellsCloud::CellsApi;
	my $config = AsposeCellsCloud::Configuration->new( client_id => $ENV{'ProductClientId'}, client_secret => $ENV{'ProductClientSecret'});
	my $instance = AsposeCellsCloud::CellsApi->new(AsposeCellsCloud::ApiClient->new( $config));

	my $remoteFolder = 'TestData/In';
	my $remoteName = 'Book1.xlsx';
	my $request = AsposeCellsCloud::Request::PutWorksheetDateFilterRequest->new();
	$request->{name} = $remoteName;
	$request->{sheet_name} = 'Sheet1';
	$request->{range} = 'A1:B1';
	$request->{field_index} = 0;
	$request->{date_time_grouping_type} = 'Year';
	$request->{year} = 1920;
	$request->{match_blanks} = 'false';
	$request->{refresh} = 'true';
	$request->{folder} = $remoteFolder;
	$request->{storage_name} = '';
	my $result = $api->put_worksheet_date_filter(request=> $request);

view raw Examples-Perl-Worksheet-AddDateFilter-1.pl hosted with ❤ by GitHub

Add a filter in an Excel worksheet Delete a Date Filter